GSDD 伴侣技能实操:从第一天到持续迭代的常用组合
用好优秀的开发技能与工具,配合 GSDD 高效开发、守住规范
发布于
aardpro aardpro
GSDD 管治理,伴侣技能管能力。这是两件事,配置方法也不同:治理立规矩,技能补能力。本文给出三件打底、按项目形态加装的常用组合,以及让它们不越界的配置方法。

先给结论,一张表说完。

层 用什么 答什么问题 不碰什么 产物归口
代码图谱 graphify 本地开源版(首选)或 CBM(--no-hooks) 谁在调用这段逻辑,改动波及哪些文件 口径、验收、决策——只在 ssot/ 线索。结论归 /gsdd-change
执行与分支 superpowers 精选 5 件:排障、评审、自验、worktree、分支收尾 怎么修、怎么审、改完怎么自证 需求、计划、验收标准 结论归 /gsdd-change
设计 design-taste-frontend 或 impeccable(按项目形态二选一) 页面哪里不对 视觉规范 人审后落 design-ui.md
按形态加装 /grill-me、自带 /security-review、Context7、浏览器验证 澄清、漏洞、库文档、页面证据 同上,一律不落盘 同上

下面按生命周期走一遍:怎么装、怎么配、第一天做什么、之后每天怎么转。

一、装:GSDD 最先,顺序就是护栏

# ① 治理先行
npx skills add aardpro/skill-gsdd -a claude-code -g

# ② 项目根目录执行 /gsdd-init,建 ssot/ 骨架并接线

# ③ 图谱:大中型项目才装
uv tool install graphifyy && graphify install --platform agents   # graphify 本地开源版,首选
# 或:pip install codebase-memory-mcp && codebase-memory-mcp install --no-hooks   # CBM 备选

# ④ superpowers 装完只留五个目录
npx skills add obra/superpowers -a claude-code -g

图谱工具两个候选,本地都免费,取舍看一点:​要不要增量更新​。

graphify 本地开源版是首选。本地 tree-sitter 建图,Apache-2.0,无使用限制;skill-only 装法零 hook,纯手动 /graphify;除代码外还能把 PDF、截图一起入图,产物自带可视化和 wiki。代价是重建靠手动。收费的是它的托管云:免费档限 3 个仓库、25k 节点,增量构建在收费墙内——本文不用它。

CBM 是备选。daemon 常驻、watcher 增量更新,多了覆盖率诊断和 change-aware 测试选择。性能有公开基准(Linux 内核全量索引 3 分钟、关系查询不到 1 毫秒;厂商的 31 仓库研究称 token 降 10 倍——厂商口径,未经独立复现)。它的默认装法带 hooks:每次 Grep/Read 前后自动注入图谱内容。建议关掉,命令里已带 --no-hooks,装完用 codebase-memory-mcp config get install_hooks 验证。原因见第三节。

superpowers 整包十几个技能,留五个:systematic-debugging、requesting-code-review、verification-before-completion、using-git-worktrees、finishing-a-development-branch。这五件全在执行层和 git 层,不产需求、计划、验收类文档。其余删掉,升级整包后重查一遍。brainstorming 和 writing-plans 会把设计文档、计划写进 docs/superpowers/,在 ssot 外长出第二份需求出处;TDD 技能的"没有失败的测试就不许写生产代码"由 AI 同时定测试和断言口径,等于自己出卷——GSDD 的规则是测试只能引用验收项编号,这条单向链第三篇讲过。

设计技能看项目形态:营销页、落地页用 design-taste-frontend(真实浏览器四档视口审查,零文件产出,不覆盖 dashboard);仪表盘、产品 UI 用 impeccable(62 条确定性检测规则,不调 LLM;装完先 hooks off;它写的 PRODUCT.md、DESIGN.md 是派生物,不进 ssot/,视觉约束经人审后走 /gsdd-change 落 design-ui.md)。

数字与命令对照各仓库官方文档,随版本演进,以 README 为准。

二、配:CLAUDE.md 五条护栏

装完在项目 CLAUDE.md 加五条。这不是复制规范内容,是裁决优先级——冲突时往哪儿指。GSDD init 自己的指路段也是这么写进去的:

  1. 伴侣技能与 ssot/ 冲突时,以 ssot/ 为准。红线原文出自 gsdd-change 技能:AI 产出与 SSOT 冲突时永远改实现。
  2. 需求、计划、规范类变更一律走 /gsdd-change;伴侣技能产出的同类文档只算草稿。
  3. 测试只引用验收项编号,不得反向定义验收;验收以 /gsdd-accept 为准。
  4. 图谱类工具:ssot/ 与 evidence/ 不进索引;图谱过期先重建再引用;hooks 默认关闭;实现类任务动手前,先查一次图谱。
  5. superpowers 只保留五个目录;升级或重装带回被删技能时,其自动触发产物一律视为草稿。

一条边界要说清:往入口文件追加裁决优先级是共存,改写指路规则、接管入口语义是越界。gstack 属于后者,所以不用。

护栏不用手工落地:/gsdd-init 会自动写入 .graphifyignore 与 .cbmignore(各含 ssot/、evidence/ 两行),声明规范目录不进图谱索引;/gsdd-audit 会对缺防护文件的项目给出提示。老项目补这两份文件,两行文本而已。

三、转:第一天和之后的每天

第一天:/gsdd-init 建骨架、问答收窄出第一批需求和验收项(第五篇讲过)→ 写五条护栏 → 装图谱工具,只装不建——空仓库没有可索引的东西。

之后的循环:

/gsdd-load 派活 → 简报
  → 关系问题查图谱(调用链、依赖、影响面)
  → 实现(ssot/ 只读)
  → /gsdd-accept:证据进 evidence/
  → 定期 /gsdd-audit 体检

代码块沿笔直的传送轨有序移动,机器人开发者在桌前工作

图谱只答关系问题。口径、验收标准、决策依据在 ssot/,图谱里没有,也不该有。

简报的规则第五篇之后有一次更新:默认 ≤2000 token、约 120 行,阈值写在 ssot/README.md 头部,项目可调;判定按行数——agent 数不了 token,数得了行。超限时压缩优先级锁死:禁止事项和数据事实一字不减,验收项全文降为编号加一行摘要加取段指引;简报开头标红「简报超限,建议拆分任务」。装不进简报,是任务太大,不是简报太小。

小机器人排队经过宽门,审查员机器人逐个核放

变更只有一条通道:/gsdd-change 提案、人审、先追加 change-log 再改文件。伴侣技能的评审意见、设计约束、调试结论需要固化的,全走这条通道。

四、拆:什么时候降

  • 项目变小、变短期:全拆,grep 加简报够用。
  • 伴侣技能在 ssot 外频繁产出文档:先补 CLAUDE.md,再谈用。
  • 图谱过期没人重建还被引用:停用图谱工具,回 grep。

尾声

GSDD 是治理层,伴侣技能是能力层。治理层只回答"以什么为准",能力层只回答"怎么做到"。两者的接口就是那五条护栏:技能的结论要变成规范,走 /gsdd-change;要变成证据,进 evidence/;除此之外,写进 ssot/ 的每一个字都该来自人审。

仓库:github.com/aardpro/skill-gsdd。项目里有值得防腐的东西,就先立治理,再装能力。

统计
© 2024-2026 Aard Blog ✉ hello@aard.ltd