@peterxiaoyang/superspec 0.1.15-alpha → 0.1.16-alpha

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/README.md +37 -36
  2. package/dist/cli.js +28 -29
  3. package/dist/install.d.ts +18 -0
  4. package/dist/install.js +161 -0
  5. package/dist/next.js +1 -1
  6. package/dist/record.js +61 -6
  7. package/dist/transition.d.ts +1 -1
  8. package/dist/transition.js +6 -6
  9. package/dist/types.d.ts +4 -1
  10. package/package.json +1 -1
  11. package/templates/workflow/agents/architect.toml +13 -0
  12. package/templates/workflow/agents/code-reviewer.toml +13 -0
  13. package/templates/workflow/agents/critic.toml +13 -0
  14. package/templates/workflow/agents/executor.toml +13 -0
  15. package/templates/workflow/agents/explore.toml +13 -0
  16. package/templates/workflow/agents/final-audit.toml +13 -0
  17. package/templates/workflow/agents/proposal-auditor.toml +13 -0
  18. package/templates/workflow/agents/test-engineer.toml +13 -0
  19. package/templates/workflow/agents/test-runner.toml +13 -0
  20. package/templates/workflow/agents/verifier.toml +13 -0
  21. package/templates/workflow/prompts/architect.md +43 -0
  22. package/templates/workflow/prompts/code-reviewer.md +34 -0
  23. package/templates/workflow/prompts/critic.md +46 -0
  24. package/templates/workflow/prompts/executor.md +32 -0
  25. package/templates/workflow/prompts/explore.md +27 -0
  26. package/templates/workflow/prompts/final-audit.md +32 -0
  27. package/templates/workflow/prompts/proposal-auditor.md +34 -0
  28. package/templates/workflow/prompts/test-engineer.md +44 -0
  29. package/templates/workflow/prompts/test-runner.md +35 -0
  30. package/templates/workflow/prompts/verifier.md +35 -0
  31. package/templates/workflow/skills/superspec-apply/SKILL.md +4 -14
  32. package/templates/workflow/skills/superspec-archive/SKILL.md +0 -7
  33. package/templates/workflow/skills/superspec-explore/SKILL.md +4 -9
  34. package/templates/workflow/skills/superspec-propose/SKILL.md +10 -11
  35. package/templates/workflow/skills/superspec-review/SKILL.md +0 -22
package/templates/workflow/skills/superspec-review/SKILL.md CHANGED
@@ -21,37 +21,15 @@ metadata:
21
21
 
22
22
  next 返回 `required_job` 说明需要 final-audit——跑 `superspec jobs packet` 拿工作说明，执行审查，`superspec record job-submit --change "<change>" --job <JOB> --report <FILE>`。
23
23
 
24
- 当前 CLI surface：
25
-
26
- - 用 `openspec validate <change>` 验证 OpenSpec artifact。
27
- - 所有任务完成后执行 `superspec transition review-ready --change "<change>"`。
28
- - 有 final-audit job 时，用 `superspec jobs packet --change "<change>" --job "<job-id>"` 取包。
29
- - 审查由 `code-reviewer`、`critic`、`architect`、`verifier` 视角覆盖；报告写入 `<final-audit.json>` 后执行 `superspec record job-submit --change "<change>" --job "<job-id>" --report <final-audit.json>`。
30
- - final-audit accepted 后，执行 `superspec transition accept --change "<change>"`。
31
-
32
24
  ## 本阶段做什么
33
25
 
34
26
  1. **确认所有任务完成**：review-ready 会检查 tasks.md 无未完成项
35
27
  2. **处理 final-audit**：审查 proposal + 实现 + 测试契约一致性
36
28
  3. **accept**：`superspec transition accept --change "<change>"`
37
29
 
38
- ## 当前限制
39
-
40
- - 当前分支没有 `verify_failure_handling` record surface。
41
- - 当前分支没有 review -> apply 的返回 transition。
42
- - 不要对已经终态的旧 job 反复提交新 report。
43
- - open job 还在时它不会发新 job。
44
- - 旧 job 才会因为 `boundFiles` 失配被拒绝终态化。
45
- - 不要指望 report 内容本身能帮你回退。
46
- - 不绑定源码文件或测试文件的 job，不是源码 / 测试 freshness 证明。
47
- - 如果这次修复只改了源码或测试，而没改任何 `boundFiles`，当前 engine 没有自动 invalidation 路径。
48
- - 源码 / 测试-only 修复不能靠旧 job 的 `boundFiles` 失配来解锁。
49
- - 如果旧 `final-audit` job 已经因为 `boundFiles` 失配或 report 拒绝而进入终态，重新执行 review-ready 获取新的 open job。
50
-
51
30
  ## Guardrails
52
31
 
53
32
  - 不改业务代码（审查阶段只读）
54
33
  - 不跳过 final-audit 直接 accept
55
34
  - 审查报告必须真实引用文件内容，不编造
56
35
  - 不跳过 transition
57
- - 不要发明当前分支没有的 `source_guidance` / `verification_review` / `main_adjudication` / `superspec check`