开发与工程

DeepChat 规格驱动开发(SDD)技能

在为 DeepChat 进行重大代码、配置、文档等变更前,创建持久的设计规格与实施计划。

58/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 6.4k
最近更新
3 天前
License
Apache-2.0
spec-driven-developmentdocumentationplanningarchitecture
+2code-reviewissue-tracking

这个 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?

使用前请注意
  • 该技能不涉及敏感操作,但用户应确认生成的文件路径和GitHub issue同步符合预期。
  • 在无网络环境或受限网络下使用本技能可能受限,建议提前确认。
  • 静态审查未验证实际执行,使用前建议在开发环境中测试。
开始前你需要
Agent 需要具备
  • 本地文件系统

此技能是 DeepChat 仓库的一部分,位于 .agents/skills/deepchat-sdd/。安装时,克隆或下载整个仓库,并将 .agents/skills/deepchat-sdd 文件夹放入你自己项目支持的技能目录。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/ThinkInAIXYZ/deepchat.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.agents/skills/deepchat-sdd" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

在开始实质性的 DeepChat 代码或文档变更前,向辅助工具描述你的目标。该技能将检查现有模式,将工作分类,并在相应目录创建所需的 spec.md、plan.md 或 tasks.md 文件(例如,新功能使用 docs/features/我的功能/)。完成后,按技能要求运行格式化和检查命令。

这个 Skill 有哪些优点和局限?

优点
  • 强制在编码前编写规格、计划和任务,减少返工。
  • 通过按目标分类(功能、缺陷、架构)帮助确定工作的优先级。
  • 默认避免不必要的文档,以避免过度设计。
  • 与 DeepChat 具体代码模式(如 Presenter、contracts、Vue 3)对齐。
局限
  • 仅限于 DeepChat 项目;对无关代码库作用有限。
  • 对于需要立即修复的小缺陷,可能显得繁琐(尽管技能建议跳过)。
  • 若过于严格,书面文档可能很快过时。
  • GitHub 同步默认关闭,要求开发者主动请求。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
DeepChat 规格驱动开发(SDD)技能 本页 58 · 推荐 ★ 6.4k 3 天前 Apache-2.0
Loki Mode 自主 SDLC 技能 53 · 谨慎使用 ★ 1.1k 3 天前 NOASSERTION
DeepChat SDD 文档清理技能 50 · 谨慎使用 ★ 6.4k 3 天前 Apache-2.0
cmux 架构规范技能 63 · 推荐 ★ 28k 1 天前 NOASSERTION
子代理驱动开发 46 · 谨慎使用 ★ 3.2k 17 天前 Apache-2.0

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
推荐
58/ 100 五分制 2.9 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全15 / 25 · 3.0/5

证据显示该技能主要是规范编写流程,不涉及敏感数据收集或网络外发。GitHub issue同步需明确要求或批准,体现了用户确认。但未明确权限最小化细节、回滚机制或数据流披露,因此扣分。

2可靠稳定9 / 20 · 2.3/5

技能指令清晰且自洽,但静态审查无法验证脚本实际执行。存在相关测试和工作流证据,但未覆盖技能关键路径,因此扣分。

3适用触发12 / 15 · 4.0/5

适用场景和边界明确,支持中文环境,但未提及网络可达性,且触发条件依赖开发者判断,因此扣分。

4规范维护10 / 15 · 3.3/5

文档结构清晰,包含使用时机、分类、强制产物、工作流等,但缺少版本控制、更新日志和已知限制披露,因此扣分。

5有效结果7 / 15 · 2.3/5

核心目标(生成规格)明确,但未提供输出示例或验证,静态审查无法确认效果,因此扣分。

6证据核验5 / 10 · 2.5/5

有CI工作流和测试证据,但未覆盖技能本身,且未提供第三方执行证据,静态审查无法确认,因此扣分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年8月7日 审查版本 4e3771b44d4f 评估证据[1][2][3][4][5][6][7][8][9][10]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

此技能对小型修复是必需的吗?
不需要,技能建议对琐碎或局部更改跳过 SDD,除非开发者明确要求。
我能在不创建 GitHub 问题的情况下使用它吗?
可以,默认不需要问题;仅在你明确要求同步时才创建。
此技能需要特殊权限或工具吗?
它可创建文件(如 spec.md)并运行 pnpm 命令,因此需要文件系统访问和可能的 shell 访问,但无需网络或 MCP。

同仓库的其他 Skills

均来自 ThinkInAIXYZ/deepchat

相关 Skills