公司 SDD 技能集定制方案

1方案概览与设计立场

目标：为团队定制一套可分发、可治理的 SDD（规范驱动开发）技能集，覆盖「需求拷问 → 规范 → 拆票 → 实现 → 审查 → 归档」全链路，并与设计流水线（DESIGN.md）打通。

为什么底座选 mattpocock skills，而不是 OpenSpec 或 spec-kit？

三条不可妥协的定制原则（源自实践复盘）：

1. 上下文会消失，共识必须落盘——术语进 CONTEXT.md、决策进 ADR、环境进 docs/agents/，技能的每个阶段都要有明确的落盘动作。
2. 产出无限而判断有限，质量门必须工具化——ready-for-agent 状态、lint 0/0、双轴审查，全部固化进技能，不依赖人的自觉。
3. 人机分工必须显式——每个技能写明「AI 全自动段落」与「人工介入点」，人只出现在拍板处。

2三大工具源码级对比

3实践经验沉淀（作为定制输入）

两篇实践记录提供了三个工具仓库里没有的实战约束，直接转化为定制要求：

4技能集总体架构

沿用 mattpocock 的分层规则并扩展一层公司治理技能（仍属编排层，但只在特定入口被调用）：

5裁剪决策清单

5.1 编排层（user-invoked）

5.2 纪律层（model-invoked）

5.3 productivity 桶

6新增技能设计

6.1 constitution — 工程宪法（译自 spec-kit）

一次性技能：建立/修订 docs/constitution.md。宪法是公司工程原则的最小集，后续所有阶段加载并受其约束。

---
name: constitution
description: 建立/修订项目工程宪法。修订须语义化版本并输出 Sync Impact Report。
---

## 流程
1. 读取公司基线宪法（docs/standards/engineering-constitution.md，只读）
2. 访谈确认项目级增补原则（≤5 条，每条须含「为什么」与「违反时的处理」）
3. 写入 docs/constitution.md，含版本号与批准日期
4. 输出 Sync Impact Report：本次变化影响哪些下游工件（模板/skill/CI）

## 规则
- 公司基线原则：项目只能引用、不能稀释（冲突 = CRITICAL，只能改项目产物）
- 项目增补原则：MAJOR=删除/重定义 · MINOR=新增 · PATCH=澄清
- 宪法冲突不可协商绕过；确需绕过时必须在 Complexity 论证段留痕

6.2 spec-validate — 规范校验（译自 OpenSpec，去掉 CLI 依赖）

纪律型技能：对 spec / delta 做结构校验，把 OpenSpec 的 Zod 规则翻译成技能正文里的检查清单。AI 逐项执行，输出 0 errors / 0 warnings 才放行。

6.3 archive — 规范归档（译自 OpenSpec 双区模型）

功能完成、验收通过后执行：把 .scratch/<feature>/ 中已达成的行为契约合并进 specs/（按 capability 组织的当前事实源），原变更目录移入 specs/archive/YYYY-MM-DD-<feature>/ 留审计。要点：

• 归档是唯一写入 specs/ 的路径——杜绝「顺手改规范」造成的漂移（与 DESIGN.md 三层治理同构）；
• 合并前跑 spec-validate 全量校验；写入失败即中止并保留原目录（可回滚）；
• 归档时检查 ticket 验收项全部勾选（借鉴 OpenSpec --archived 检查）。

6.4 design-pipeline — 设计流水线（源自实践，固化为技能）

把两篇博文中的设计环节做成与开发环节平行的技能，五个阶段各带质量门：

6.5 analyze — 只读一致性分析（译自 spec-kit）

implement 前执行，只读不改文件：重复与歧义扫描、欠指定项识别、宪法对齐、覆盖缺口（哪些 spec 需求没有任何 ticket 承载）、产物间矛盾。输出 CRITICAL~LOW 分级报告，限 50 条。CRITICAL 项未清零前，implement 拒绝开始。

6.6 sdd-map — 路由图（改自 ask-matt）

人读的流程地图：什么规模的工作走哪条路。单会话装得下的小活直接 implement；标准工作走全流程；超大/多雾工作先 wayfinder 建决策地图；涉及界面的工作在 grill 后插入 design-pipeline。

7目录与工件约定

统一所有项目的仓库布局（每仓库初始化时由 setup-sdd 生成骨架）：

.
├── CLAUDE.md                      # 入口：指向宪法、CONTEXT.md、工作流地图
├── CONTEXT.md                     # 领域术语表（grill-with-docs 实时落盘；spec 冲突时以此为准）
├── docs/
│   ├── constitution.md            # 项目宪法（公司基线 + 项目增补，语义化版本）
│   ├── adr/                       # 架构决策记录（三道闸门通过的决策落这里）
│   ├── agents/                    # 环境配置（AI 的"入职文档"）
│   │   ├── issue-tracker.md       #   工单系统约定（公司唯一系统）
│   │   ├── domain.md              #   领域背景
│   │   └── design-pipeline.md     #   设计流水线操作指引 + 已知坑
│   └── standards/
│       └── engineering-constitution.md   # 公司基线宪法（只读）
├── DESIGN.md                      # 公司标准设计规范（只读消费；有 UI 的项目引入）
├── DESIGN.overrides.md            # 项目偏离（只记 delta + 理由）
├── .scratch/<feature-slug>/       # 进行中工作区
│   ├── spec.md                    #   Status: ready-for-agent ...
│   └── issues/NN-*.md             #   曳光弹切片，各带 Blocked-by 与 Status
└── specs/                         # 已归档行为契约（事实源，按 capability；archive 唯一写入口）
    └── archive/YYYY-MM-DD-*/      #   归档留痕（审计上下文）

8质量门与治理机制

四个来源的门禁统一收口到一张表，每个门禁都有明确的「不过怎么办」：

9人机分工

把分工写进每个技能的正文，AI 就能自动跑到「需要人拍板」的那一步并递上决策材料——这是流程可复现的前提。

10落地路线图

11附录

11.1 命令速查

# 初始化（每仓库一次）
/setup-sdd                        # 写 docs/agents/、CLAUDE.md 骨架、工单约定
/constitution                     # 建项目宪法（公司基线 + 项目增补）

# 标准工作流
/grill-with-docs <一句话想法>      # 访谈 → CONTEXT.md / ADR 落盘
/to-spec                          # → .scratch/<slug>/spec.md（过 spec-validate 后 ready-for-agent）
/to-tickets                       # → issues/NN-*.md 曳光弹切片 + 依赖图
/analyze                          # implement 前只读一致性检查
/implement issues/NN-*.md         # 单票单会话：tdd → 三轴 review → 提交勾选
/archive <feature-slug>           # 合入 specs/ + 归档留痕

# 设计分支（有界面的工作）
/design-pipeline                  # DESIGN.md → HTML 原型 → (人) Figma → 对齐 → overrides 治理

# 地图
/sdd-map                          # 什么规模走哪条路

11.2 界面类 ticket 进入 ready-for-agent 前的检查清单

• ☐ 规范就绪——DESIGN.md 存在且 lint 0/0
• ☐ 原型就绪——HTML 原型过评审，tokens 全部取自规范（export 产物，非手抄）
• ☐ 偏离显式——所有偏离在 DESIGN.overrides.md 且附理由
• ☐ 词汇对齐——spec/ticket 领域名词全部能在 CONTEXT.md 找到定义
• ☐ Figma 存档——画板已生成，链接记录在 ticket 中
• ☐ 标准纯净——公司标准文件本次零改动（git diff 为空）
• ☐ analyze CRITICAL = 0

11.3 参考资料与调研依据

• 技能骨架：/Users/junjian/GitHub/mattpocock/skills —— 分层规则见 README.md；编排者范式见 skills/engineering/implement/SKILL.md、grill-with-docs/SKILL.md；模板内嵌见 to-spec/SKILL.md、to-tickets/SKILL.md
• 防漂移机制：/Users/junjian/GitHub/Fission-AI/OpenSpec —— delta 格式见 schemas/spec-driven/templates/；校验规则见 src/core/validation/validator.ts；归档合并见 src/core/specs-apply.ts
• 宪法门禁：/Users/junjian/GitHub/github/spec-kit —— 方法论见 spec-driven.md；宪法模板见 templates/constitution-template.md；analyze 见 templates/commands/analyze.md
• 实践经验：博客《AI 原生 SDLC 实践：mattpocock skills 走通全链路》（2026-09-17）、《AI 原生设计流水线》（2026-09-19）—— wang-junjian.github.io/posts/2026/