SPARV 是一个极简工作流技能,目标是一次走完“需求→可验证交付”,并把关键决策写入外部记忆,而不是依赖假设。
用途与阶段:固定五阶段 specify|plan|act|review|vault,阶段名存入 .sparv/state.yaml:current_phase。
核心规则:10 分规格门,Spec 评分 0-10,须 >=9 才进入 Plan;2-Action 保存,每 2 次工具调用向 .sparv/journal.md 追加一条;3 次失败协议,连续 3 次失败即停止并上报用户;EHRB 在检测到生产/敏感数据/破坏性/计费 API/安全关键等高风险时要求用户明确确认。
增强规则 v1.1:当 Specify 任一维度得分 <2,需声明 UNCERTAIN: <what> | ASSUMPTION: <fallback>,在 Plan 前把所有假设列入日志,对含糊需求给出 2-3 个选项。需求路由按模式区分:Quick 条件为 score>=9 且文件 <=3 且无 EHRB,流程为 Specify→Act→Review;否则走 Full 全流程。Quick 跳过正式 Plan,但仍需把完成承诺写入日志、遵守 2-Action 保存、Review 阶段必做。
外部记忆:在项目根运行 ~/.claude/skills/sparv/scripts/init-session.sh --force 初始化;.sparv/state.yaml 保存状态机(session_id/current_phase/action_count/consecutive_failures),.sparv/journal.md 为统一日志,.sparv/history/<session_id>/ 为归档目录。
各阶段:Specify 按价值、范围、验收、边界、风险五项各 0/1/2 打分,<9 继续提问,>=9 写出可验证的 completion_promise 后进入 Plan;Plan 拆成 2-5 分钟粒度的原子任务,每个带可验证输出/测试点并写入日志;Act 遵循 TDD(无失败测试不写生产代码),每 2 次操作自动写日志,失败计数用 failure-tracker.sh fail --note "..." 或 reset;Review 先规格符合再代码质量,最多 3 轮修复,结束前运行 reboot-test.sh --strict;Vault 用 archive-session.sh 归档。CHANGELOG 更新可用 changelog-update.sh --type <Added|Changed|Fixed|Removed> --desc "...",并在 Vault 阶段维护 .sparv/kb.md 的模式、决策与陷阱。
脚本与钩子:init-session.sh、save-progress.sh、check-ehrb.sh、failure-tracker.sh、reboot-test.sh、archive-session.sh;hooks/hooks.json 中 PostToolUse 调 save-progress.sh,PreToolUse 调 check-ehrb.sh --diff --dry-run(仅提示不写状态),Stop 调 reboot-test.sh --strict。限制与收费、平台、效果等资料暂未提供,请以实际环境为准。