Indexion 规范驱动开发
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/trkbt10-indexion-skills-indexion-sdd。
技能介绍
要解决什么问题
用 cc-sdd、Codex 做规范驱动开发(SDD)时,代理侧多半是定性评审;而 indexion 提供的是词汇重叠、需求级漂移、可追溯矩阵等可量化结果。两者若各跑各的,容易出现「代理说可以合,但 requirements 与 src/ 仍大量 DRIFTED」,或更隐蔽的:spec align 显示 MATCHED,需求却把原文的 shall decode 写成了 shall return error——词汇重合但意图颠倒,往往要到 E2E 才爆雷。
本技能描述如何把 indexion 的 spec align、spec verify 嵌进 SDD 编排:RFC/文档 → SDD 需求草案 → 代理实现 → 校验闭环,并在每个 $kiro-impl 提交后做漂移门禁,而不是只在最后看一眼 diff。
技能如何工作
整体流程是 RFC → Implementation → Validation,关键能力来自 SKILL.md 中的分步约定:
- 规格 → 草案(Step 1):从 RFC 纯文本、ISO/IEC
.spec.txt或 Markdown 拉取规范,生成与 cc-sdd 兼容的### Requirement N:/#### N.M:层级;后续由$kiro-spec-requirements再细化为 EARS 与验收条件。 - 保真审查(Step 1.5):
spec align只反映相邻抽象层之间的词汇重叠,不能把源规范直接对设计或代码做 align;此外需人工扫 intent inversion 与not yet supported、stub等逃避式写法。 - 阶段间与逐任务门禁(Step 2 / 2.5):在 Codex 长会话之间插入
indexion spec align diff与spec align status(--fail-on drifted或any);每个任务提交后,若对应需求仍为 DRIFTED、SPEC_ONLY 或不应出现的 SHALLOW,不得进入下一任务。SHALLOW 表示需求只落到类型/结构体声明、同文件缺少非平凡实现逻辑。 - SHALLOW 与 E2E(Step 2.6–2.9):Phase B 常需多轮「在同文件补方法」;
Shallow: 0只说明词汇对齐,不能代替端到端测试——真实输入下缺表、未接线 API 等仍要单独写 E2E 再定向补 Codex 提示。 - 校验环(Step 3 / 3.5):串联
spec verify、align diff、trace、status,把报告注入 validate-impl 提示做 GO/NO-GO;通过后若仍有 DRIFTED/SPEC_ONLY,走词汇对齐修复(面向公共声明的文档注释,而非私自改业务逻辑)。
适用边界与注意点
- 启动 cc-sdd 时
--lang必须跟实现语言(代码是英文就用--lang en),与规范文档语言无关;语言错配会破坏 align 的词汇匹配。 - Step 0 要先确认项目目录内 indexion 可用且 KGF 认识你的需求格式;否则用编排侧代理门禁(Step 2.8),并注意直接调二进制时可能要
--specs-dir。 - 禁止手工提交实现代码:停滞恢复(Step 2.7)只能 kill 进程后用 resume 提示让 Codex 验证并提交,否则会绕过 SDD 的证据链。
- CLI 入口若几乎没有 public API,
spec align对入口模块有已知盲区——仅靠 doc 注释修补可能不够,需有意识暴露带词汇的公共入口。
使用场景
- 持有 RFC 或 ISO 技术文档,需要按 cc-sdd 的 $kiro-spec-* 阶段把规范落成库或包并保持需求 ID 格式一致。
- 每个 $kiro-impl 任务提交后、合并前,要用 indexion 确认对应 Requirement 未仍处于 DRIFTED、SPEC_ONLY 或不合规的 SHALLOW。
- requirements.md 已从规范生成,要在进入 Codex 实现前排查「词汇匹配但意图相反」及 not yet supported 类逃避写法。
- 用户要求 run the SDD loop 或 validate against the spec 时,需要串联 spec verify、align 报告并驱动 validate-impl 的 GO/NO-GO 决策。
适合人员
- 维护「外部规范 → 内部实现」代码库的工程师,合并前需要可复现的 indexion 门禁而不只依赖代理口头通过。
- 用 cc-sdd v3 skills 模式编排 Codex/Claude Code、并在阶段间插入 spec align 命令的 SDD 流程编排者。
- Phase B 反复出现 SHALLOW、需要按「类型与同文件非平凡方法同存」规则做多轮收敛的实现负责人。
- kiro-validate-impl 已通过但 spec align 仍报 DRIFTED/SPEC_ONLY、需在公共 API 注释上补规范词汇的实现工程师。