DeepChat 规格驱动开发（SDD）技能
在为 DeepChat 进行重大代码、配置、文档等变更前，创建持久的设计规格与实施计划。
证据显示该技能主要是规范编写流程，不涉及敏感数据收集或网络外发。GitHub issue同步需明确要求或批准，体现了用户确认。但未明确权限最小化细节、回滚机制或数据流披露，因此扣分。
技能指令清晰且自洽，但静态审查无法验证脚本实际执行。存在相关测试和工作流证据，但未覆盖技能关键路径，因此扣分。
适用场景和边界明确，支持中文环境，但未提及网络可达性，且触发条件依赖开发者判断，因此扣分。
文档结构清晰，包含使用时机、分类、强制产物、工作流等，但缺少版本控制、更新日志和已知限制披露，因此扣分。
核心目标（生成规格）明确，但未提供输出示例或验证，静态审查无法确认效果，因此扣分。
有CI工作流和测试证据，但未覆盖技能本身，且未提供第三方执行证据，静态审查无法确认，因此扣分。
- 该技能不涉及敏感操作，但用户应确认生成的文件路径和GitHub issue同步符合预期。
- 在无网络环境或受限网络下使用本技能可能受限，建议提前确认。
- 静态审查未验证实际执行，使用前建议在开发环境中测试。
这个 Skill 能做什么，适合哪些场景？
该技能引导在投入编码前，为 DeepChat 项目中具有上下文共享需求或需持久记录的实质工作，编写规格文档、实施计划和任务清单。它按目标将工作分类为功能、复杂缺陷或架构变更，并分别在 docs/features、docs/issues 和 docs/architecture 下创建文件夹。该技能秉持文档纪律，默认避免过度设计，并仅在开发者明确要求时进行 GitHub 问题同步。它旨在与 DeepChat 现有的代码模式保持一致，如主进程 Presenter 边界、类型化 shared/contracts 和 Vue 3 Composition API。
该技能在执行前检查当前代码和文档，判断变更是否足够实质而需要 SDD，并将目标分类为三个文档目录之一：docs/features（新功能）、docs/issues（复杂缺陷）、docs/architecture（重构或架构）。对于功能和架构目标，它会创建 spec.md、plan.md 和 tasks.md 三个文件；对于复杂缺陷，仅创建 spec.md。它要求所有 [NEEDS CLARIFICATION] 标记在实施前得到解决，将工作划分为可提交的小块，并记录相应的 GitHub 问题（可选）。在开发过程中，它更新任务清单，并在建议前按需运行 pnpm run format、pnpm run i18n 和 pnpm run lint。
- 希望为 DeepChat 新功能（如新增模型集成）创建共享计划，以便多开发者对齐的贡献者。
- 需要为难以定位的复杂缺陷记录根因和修复方案，以避免未来开发者重复排查的开发者。
- 进行重构或依赖边界调整的技术负责人，希望在代码改动前记录架构决策。
- 需要将大型变更拆分为可审查子任务的工程师，每个子任务有明确文档支持。
这个 Skill 有哪些优点和局限？
- 强制在编码前编写规格、计划和任务，减少返工。
- 通过按目标分类（功能、缺陷、架构）帮助确定工作的优先级。
- 默认避免不必要的文档，以避免过度设计。
- 与 DeepChat 具体代码模式（如 Presenter、contracts、Vue 3）对齐。
- 仅限于 DeepChat 项目；对无关代码库作用有限。
- 对于需要立即修复的小缺陷，可能显得繁琐（尽管技能建议跳过）。
- 若过于严格，书面文档可能很快过时。
- GitHub 同步默认关闭，要求开发者主动请求。
如何安装这个 Skill？
此技能是 DeepChat 仓库的一部分，位于 .agents/skills/deepchat-sdd/。安装时，克隆或下载整个仓库，并将 .agents/skills/deepchat-sdd 文件夹放入你自己项目支持的技能目录。
如何使用这个 Skill？
在开始实质性的 DeepChat 代码或文档变更前，向辅助工具描述你的目标。该技能将检查现有模式，将工作分类，并在相应目录创建所需的 spec.md、plan.md 或 tasks.md 文件（例如，新功能使用 docs/features/我的功能/）。完成后，按技能要求运行格式化和检查命令。