先给结论,一张表说完。
| 层 | 用什么 | 答什么问题 | 不碰什么 | 产物归口 |
|---|---|---|---|---|
| 代码图谱 | 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 自己的指路段也是这么写进去的:
- 伴侣技能与
ssot/冲突时,以 ssot/ 为准。红线原文出自 gsdd-change 技能:AI 产出与 SSOT 冲突时永远改实现。 - 需求、计划、规范类变更一律走
/gsdd-change;伴侣技能产出的同类文档只算草稿。 - 测试只引用验收项编号,不得反向定义验收;验收以
/gsdd-accept为准。 - 图谱类工具:
ssot/与evidence/不进索引;图谱过期先重建再引用;hooks 默认关闭;实现类任务动手前,先查一次图谱。 - 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。项目里有值得防腐的东西,就先立治理,再装能力。