DeepChat SDD 文档清理技能
在实现和验证完成后，安全地清理、修剪和整理 DeepChat SDD 文档。
技能明确要求仅在开发者明确请求清理时运行，并设有“绝不删除”清单（活动任务、未澄清标记、被引用的文档等），展示了对数据丢失风险的谨慎。然而，技能授权直接删除文件，且未要求显式用户确认，也未提供回滚机制。gh 检查仅在可用时使用，但并未明确限制权限范围。发布者未经验证。因此扣分：缺少显式确认、回滚和更清晰的权限边界。
技能提供了清晰的步骤和验证命令，但为静态审阅，未执行关键路径。依赖外部工具（find、rg、gh）且未处理这些工具不可用时的情况（除了gh），外部依赖的可用性未保证。错误处理有限，未定义在异常输入（如不存在的目录）下的行为。因此扣分：未执行测试、错误处理薄、外部依赖保证不足。
技能精准定义了触发条件（仅在开发者明确要求时）和非适用场景（不作为常规工作的自动步骤），场景清晰。但未明确声明能力边界和非适用范围的详尽列表（例如，哪些文档类型适合清理、哪些不适合），也未提供示例。但环境适配良好，不依赖海外服务，适合中国用户。因此扣分：能力边界和非适用范围不够详尽，缺少示例。
技能文件提供了结构化的工作流程和规则，包含网址、依赖（gh）和验证步骤。但缺少安装说明（并非独立安装）、常见问题、变更日志、版本信息和维护责任。发布者未经验证，维护责任不明确。因此扣分：缺少版本、变更日志、维护责任和常见问题。
技能的目标和收益明确，清理规则详细。但为静态审阅，未验证输出，且收益对比（如相比手动清理）的证据有限。因此扣分：未验证输出、收益对比证据不足。
技能提供了验证步骤和清理规则，但未提供测试套件或可复现的第三方执行证据。CI 工作流存在（打包工作流），但未覆盖此技能的关键路径。因此扣分：无测试或可复现执行证据。
- 技能会直接删除文件，务必在运行前确认开发者明确请求，并检查“绝不删除”清单。
- gh 未安装或未认证时，可能错误地保留或删除文档，需依赖本地代码和测试证据。
- 未提供回滚机制，删除操作不可逆，建议在使用前备份。
这个 Skill 能做什么，适合哪些场景？
该技能用于清理 DeepChat 项目中过时的 SDD（规范驱动开发）文档。它会扫描 docs/features、docs/issues 和 docs/architecture 目录，识别已完成或过时的文档，并删除它们。它优先使用多智能体审查，并通过检查关联的 GitHub issue 来确认完成状态。该技能仅在用户明确要求时运行，不会作为常规开发流程的自动步骤。
扫描 docs/features、docs/issues 和 docs/architecture 目录。检查 docs/spec-driven-dev.md、docs/README.md 和 git status。组织并行子智能体审查文档目录。验证有证据的变更，并保留 keep/delete/update 列表。删除已完成功能或架构目标的 plan.md 和 tasks.md 文件。删除已关闭 GitHub issue 关联的已完成 issue 文件夹。删除已移除功能或过时架构的文件夹。更新受架构重构影响的历史功能规范。运行 rg 和 git status 进行验证。
- 开发者在完成功能或架构目标后，想要清理过时的计划文件。
- 开发者在完成错误修复后，想要删除与已关闭 GitHub issue 关联的 issue 文档。
- 开发者在重构后，想要整理文档目录，同时保留仍然有效的规范。
- 开发者在产品移除功能后，想要清理相关文档文件夹。
这个 Skill 有哪些优点和局限？
- 通过删除过时文件，帮助保持文档整洁和最新。
- 通过并行审查实现多智能体协作，提高效率。
- 包含防止删除重要文档的安全措施，如主动工作和含有未解决澄清标记的文档。
- 在可能的情况下，通过 GitHub CLI 验证 GitHub issue 状态。
- 需要明确的用户请求；不会自动运行，可能限制其实用性。
- 依赖 GitHub CLI 验证 issue 状态；如果未安装，则无法执行验证。
- 仅支持 DeepChat 项目特定的文档结构，通用性有限。
- 无测试套件，必须仔细审查以避免意外删除。
如何安装这个 Skill？
将此技能文件夹（包含 SKILL.md）放入代理的 skills 目录。例如，对于 Claude Code，放入 ~/.claude/skills/。
如何使用这个 Skill？
在提示中明确请求 SDD 清理，例如：“请清理过时的 SDD 文档。”或“请整理文档目录。”该技能不会自动运行。