dsh-workspace-auditor

Readme

# dsh-workspace-auditor

工作空间审计官 —— 为「个人 AI 工作空间」定期体检的 DeepSeek Harness（DSH）agent 预设。

> 只审计，不执行；工具失败如实上报；不假设；报告必须落盘。

## 这是什么

一个 DSH agent 预设（preset + skill）：定期审计工作空间、守护秩序、并让自己不断进化。审计结果与记忆沉淀在工作空间内的台账目录（`ops/reports/audit/`），每次审计站在上一次的肩膀上。

审计五维：

1. **项目看板** —— 未完成任务、过期任务、看板与本地证据的漂移
2. **结构符合度** —— 工作空间规范 vs 实际布局：AI 有没有乱放文件、用错目录、新目录没写进规范
3. **AI 日志与踩坑** —— 重复失败、规范违反、未闭环项（ops/logs、wiki/log.md、git log）
4. **优化建议** —— 流程、规范、工具的改进点（只建议，不擅改）
5. **DSH 会话审计** —— 用 session 查询工具审阅会话轨迹，把 AI 行为的第一手记录纳入审计上下文

两种模式：**全量审计**（四维 + 会话，输出固定格式报告并落盘）和**快速体检**（2–3 分钟，不写报告文件）。

## 安装

### 方式一：DSH 插件市场一键安装

本仓库已打上 `dsh-plugin` topic，DSH 插件市场（如 [DSH-Plugins-Marketplace](https://github.com/bradeGithub/DSH-Plugins-Marketplace)）自动收录后可在 Web GUI 一键安装。

### 方式二：手动复制

```bash
# macOS / Linux
mkdir -p ~/.dsh/.agent-presets
cp -r . ~/.dsh/.agent-presets/workspace-auditor

# Windows (PowerShell)
New-Item -ItemType Directory "$env:USERPROFILE\.dsh\.agent-presets\workspace-auditor" -Force
Copy-Item -Path .\preset.yml, .\agent.cordis.yml, .\skills -Destination "$env:USERPROFILE\.dsh\.agent-presets\workspace-auditor" -Recurse
```

重启 DSH，在新会话中选择该预设。

## 使用

说「审计 / 体检 / 检查工作空间 / 看板提醒 / 定期检查 / workspace audit」即触发。

首次会话建议用 DSH 的 `schedule_create` 建立周期提醒：

- 全量审计：每周一次
- 快速体检：每日一次

## 适配你的工作空间

本预设默认面向「四层结构」的个人工作空间（`studio/` 项目层、`bAI/` 知识层、`ops/` 运维层 + 规范文件 `AGENTS.md`）。如果你的工作空间结构不同，按需修改：

- `agent.cordis.yml` 中的 persona 与审计维度
- `skills/workspace-audit/SKILL.md` 中的检查清单与台账路径

## 文件结构

```
dsh-workspace-auditor/
├── README.md
├── preset.yml                  # 预设元数据（名称 / 描述 / 触发词）
├── agent.cordis.yml            # agent 预设组合（persona + 工具 + skill 挂载）
└── skills/
    └── workspace-audit/
        └── SKILL.md            # 审计流程：触发 / 两种模式 / 检查清单 / 输出格式
```

## 许可

MIT