sdd

Plugin sdd from marketplace ai-kit in fingergohappy/ai-kit. Commands read from the repo's manifest — today.

Skills (9)

• auto-cr

  把一个已存在的 CR-NNN 从当前状态一路推到落实前, 中途不问用户: 每一步照 sdd.py status 的下一步做, 三次 review 派给 tmux 里的 crew 工具 (codex / pi / zcode 等) 并行审 (一个车道一个窗口), 结果合并回 reviews/0N-<stage>.md. 业务上拿不准的先按自己推荐的做法执行, 把问题记成 REQ 第 10 节的 OQ 条目, 攒到最后一起给用户确认. 当用户说 "自动推进 CR-005", "让它自己跑完", "不用问我, 一路做下去", "让 codex 和 pi 并行审这个 CR", "全自动走 sdd 流程

• create-cr

  立一次工作单元 CR-NNN (docs/sdd/cr/) 并建好 work/CR-NNN-<slug>/ 工作目录: 已有 REQ 的业务改行为写变更 CR (按 FR-x / BR-y / AC-z 逐条 "现行 -> 变更后"), 全新业务写立项 CR (立项动机 / 交付范围 / 对现有系统的影响). 当用户说 "改 XX 的行为", "加一个功能 / 开关 / 配置", "做一个新业务 / 新功能 / 从零做个 XX", "立个 CR / 变更 / 需求变更", "把草稿变成变更" 时使用 -- 只要验收标准会变或要新做一个业务就走这里. 不写代码, 不改 REQ (落实时才改).

• draft

  在立需求 (REQ) 或变更 (CR) 之前把问题想清楚: 只读代码, 把 "我以为" 换成带 file:line 的事实, 列选项与取舍, 写成草稿放进 docs/sdd/draft/<slug>/. 当用户说 "先想想 / 讨论一下 / 梳理一下 / 有几种做法 / 看看现在是怎么实现的 / 写个草稿或提案", 或者提出一个改动但业务还没有 REQ / CR 时使用 -- 哪怕用户没说 "草稿" 两个字. 不写代码.

• implement-cr

  实施一个变更 CR-NNN 的 "下一件事": 处理 review 发现, 按已审过的 spec 用 TDD (red -> green) 分步实现 (整段做完跑一次回归, 提交一次), 最后落实 -- 更新 REQ 到新结论, CR 置 fixed. 当用户说 "实施 / 开始做 / 继续做 / 接着做 CR-NNN", "按 spec 写代码", "处理 review 的发现", "落实 / 收尾这个变更" 时使用. 七个命令里唯一会改项目代码的; 写 spec 是 /spec, 三次 review 是软闸门, 缺了要停下来问.

• req

  把一个业务的现行逻辑写成需求文档 REQ-NNN (docs/sdd/req/), 内容是当前功能的结论: 逐条编号的 FR / BR / AC, 状态机与规则表, 数据影响, 代码落点. 当用户说 "把 XX 的业务逻辑整理 / 收集 / 写下来", "这个功能现在是怎么工作的, 记成文档", "建个 REQ", "先收集旧逻辑", 或 /create-cr 发现目标业务没有 REQ 时使用. 也用于给全新业务写目标形态的 REQ (状态 draft). 不写代码.

• review-cr

  对一个变更 CR-NNN 做三次 review 之一: docs (CR + REQ delta, 写 spec 前), spec (实施计划, 写代码前), impl (代码 vs spec vs AC, 落实前); 或对已处置的发现做复核. 按车道审, 每条发现带 file:line 证据与最小修复, 写进 work/CR-NNN-<slug>/reviews/0N-<stage>.md, 状态 to fix / fixing / fixed. CR fixed 后用 distill 模式把 review 里犯过的错提炼进入库的错题本 docs/sdd/lessons.md, 再逐份判工作

• runbook

  按环境、按批次写上线手册并执行, 执行中记录问题: pre 读 docs/sdd/release/<批次>/ 的全部上线文件 (CR / 工单的上线操作, 手工 SQL, go-live 核查, seed, 一次性程序, 开关, 管理端动作, mock 变更) 与该环境已有的 log.md, 写出 release/runbook/<环境>/<批次>/runbook.md, 并把要用的 SQL 与脚本复制进同目录填好该环境参数; run 从第一个未完成步骤逐步执行, 写操作先问, 每步记进 log.md, 遇到问题先分环境问题还是代码问题; auto 先 pre 再 run. 当用户说 "/ru

• sdd

  需求 (REQ) / 变更 (CR) / 实施 spec / review 工作流的共享底座与状态入口. 当用户问 "到哪一步了", "下一步做什么", "检查一下文档一致性 / 索引", "这个 CR 什么状态", 或提到 REQ-NNN / CR-NNN / docs/sdd 时使用; /draft /req /create-cr /spec /implement-cr /review-cr /auto-cr /runbook 这些命令的模板, 脚本与约定都在这里, 它们运行前也要读本文的约定部分.

• spec

  为一个变更 CR-NNN 写实施 spec (docs/sdd/work/CR-NNN-<slug>/spec.md): 先只读侦察把现状核实成带 file:line 的事实, 再据此写改动总览, 数据与迁移, 分步实施顺序 (每步独立可合并可回退), 测试计划 (对应每条 AC), 风险与回退, 明确不做, 上线检查单. 当用户说 "写 spec / 实施方案 / 技术方案 / 改造计划", "这个怎么改", "列个步骤 / 拆一下任务", "先看看要动哪些地方", 或 sdd status 的下一步指向写 spec 时使用. 只读代码, 不写代码 -- 实施是 /implement-cr

Similar plugins