Agent Skills
返回列表
💻

Indexion 规范驱动开发

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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 注释上补规范词汇的实现工程师。