DeepChat SDD Cleanup 是一个面向 DeepChat 规范驱动开发(SDD)文档的清理技能。它的核心用途是在开发者明确要求时,对已完成实现和验证的 SDD 文档进行清理、修剪、整理或删除已完成/过时的文件。该技能不会作为普通功能、缺陷、架构或发布工作的自动最终步骤运行。
主要能力与工作流程:
- 检查 docs/spec-driven-dev.md、docs/README.md 和 git status。
- 使用 find 或 rg 盘点 docs/features、docs/issues 和 docs/architecture 目录。
- 在可用时优先使用并行子代理审查:一次审查 docs/features,一次审查 docs/issues,一次审查 docs/architecture,并可选择对拟删除项进行验证。
- 仅在有明确证据时应用更改,并保留一份简洁的保留/删除/更新清单用于交接。
- 编辑后验证引用。
清理规则:
- 已完成的功能或架构目标:删除 plan.md 及任何遗留的 tasks.md;仅当 spec.md 仍定义维护中的契约、回归防护、平台策略或架构决策时保留。
- 已完成的 issue 目标:当关联的 GitHub issue 已关闭,或实现与验证证据证明缺陷不再存在时,删除该 issue 文件夹。
- 已移除的功能:当产品/代码路径已不存在且规范没有可复用的决策记录时,删除其文件夹。
- 过时的架构:当模块已被完全替换且文档不再描述维护中的边界时,删除其文件夹;否则更新规范。
- 受架构重构影响的历史功能规范:更新保留的规范,而不是留下相互矛盾的文档。
GitHub 检查:
仅在 gh 已安装并认证时使用。对于关联 issue 的文档,尽可能通过 gh issue view <number> --json state,url,title 验证关闭状态。如果 gh 不可用,不要仅因 GitHub 链接看起来陈旧就删除。
永不删除:
- 存在未勾选 plan.md 步骤或遗留 tasks 的活跃工作。
- 任何包含未解决 [NEEDS CLARIFICATION] 的文档。
- 被 docs/README.md、docs/ARCHITECTURE.md、docs/FLOWS.md 或 AGENTS 指令引用的文档,除非在同一次更改中更新了引用。
- 运行时基线或机器读取的文件,除非清理请求明确涵盖它们。
验证:
运行 rg -n "plan.md|tasks.md|docs/archives|NEEDS CLARIFICATION" docs AGENTS.md .agents/skills 并检查任何过时的策略引用。运行 git status --short。对于仅 Markdown 的清理,格式化/lint 命令是可选的,除非仓库指令或涉及的生成文件要求。
适用场景:适用于 DeepChat 项目中 SDD 文档的维护与整理,特别是功能、issue 或架构工作完成并验证后,需要清理文档目录时。
限制:该技能仅在开发者明确要求时运行;不自动执行;删除操作需要明确证据;gh 不可用时不能仅凭链接陈旧删除;存在未解决澄清项或被引用的文档不得删除。