@fitlab-ai/agent-infra 0.9.13 → 0.9.14

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 (280) hide show
  1. package/bin/cli.ts +26 -9
  2. package/dist/bin/cli.js +173 -157
  3. package/dist/bin/internal-cli.js +42 -21
  4. package/dist/lib/agent-client.js +5 -0
  5. package/dist/lib/internal/agent-client.js +5 -2
  6. package/dist/lib/internal/cli-route-inventory.js +152 -0
  7. package/dist/lib/internal/codex-lifecycle.js +9 -6
  8. package/dist/lib/internal/codex-sandbox-controller.js +8 -2
  9. package/dist/lib/internal/git-workflow.js +10 -6
  10. package/dist/lib/internal/platform-checks.js +16 -4
  11. package/dist/lib/internal/platform-comment.js +16 -4
  12. package/dist/lib/internal/platform-context.js +4 -1
  13. package/dist/lib/internal/platform-issue.js +12 -4
  14. package/dist/lib/internal/platform-metadata.js +88 -0
  15. package/dist/lib/internal/platform-pr-review.js +16 -3
  16. package/dist/lib/internal/platform-pr.js +24 -10
  17. package/dist/lib/internal/platform-release-notes.js +6 -3
  18. package/dist/lib/internal/platform-security.js +93 -0
  19. package/dist/lib/internal/pr-review-grade.js +14 -3
  20. package/dist/lib/internal/release-workflow.js +19 -5
  21. package/dist/lib/internal/sandbox-control.js +22 -5
  22. package/dist/lib/internal/task-activity.js +13 -4
  23. package/dist/lib/internal/task-artifact.js +186 -27
  24. package/dist/lib/internal/task-context.js +4 -1
  25. package/dist/lib/internal/task-create.js +48 -15
  26. package/dist/lib/internal/task-delivery.js +4 -1
  27. package/dist/lib/internal/task-event.js +4 -1
  28. package/dist/lib/internal/task-finalization.js +4 -1
  29. package/dist/lib/internal/task-invalidation.js +4 -1
  30. package/dist/lib/internal/task-ledger.js +12 -1
  31. package/dist/lib/internal/task-lifecycle.js +4 -1
  32. package/dist/lib/internal/task-operation-registry.js +421 -0
  33. package/dist/lib/internal/task-orchestration.js +12 -0
  34. package/dist/lib/internal/task-override.js +10 -3
  35. package/dist/lib/internal/task-qualification.js +90 -0
  36. package/dist/lib/internal/task-review.js +4 -1
  37. package/dist/lib/internal/task-short-id.js +11 -1
  38. package/dist/lib/internal/task-snapshot.js +4 -1
  39. package/dist/lib/internal/task-validate.js +7 -2
  40. package/dist/lib/internal/task-verify.js +5 -1
  41. package/dist/lib/internal/task-warning.js +8 -1
  42. package/dist/lib/platform/comment-safety.js +226 -0
  43. package/dist/lib/platform/github-provider.js +233 -6
  44. package/dist/lib/platform/issue-comments.js +146 -34
  45. package/dist/lib/platform/pr-change-report.js +6 -12
  46. package/dist/lib/platform/pr-summary.js +28 -7
  47. package/dist/lib/platform/provider-contract.d.ts +67 -1
  48. package/dist/lib/platform/provider-contract.js +6 -2
  49. package/dist/lib/platform/provider-validation.js +76 -3
  50. package/dist/lib/platform/pull-requests.js +115 -170
  51. package/dist/lib/platform/repository-metadata.js +377 -0
  52. package/dist/lib/platform/security-alerts.js +155 -0
  53. package/dist/lib/platform/verification-sync.js +33 -26
  54. package/dist/lib/process-data/index.js +7 -0
  55. package/dist/lib/run/index.js +5 -0
  56. package/dist/lib/sandbox/commands/control-status.js +22 -0
  57. package/dist/lib/sandbox/commands/create.js +32 -6
  58. package/dist/lib/sandbox/commands/ls.js +5 -0
  59. package/dist/lib/sandbox/commands/rm.js +827 -120
  60. package/dist/lib/sandbox/commands/show.js +16 -0
  61. package/dist/lib/sandbox/control/client.js +83 -9
  62. package/dist/lib/sandbox/control/completed-reentry.js +85 -0
  63. package/dist/lib/sandbox/control/container-identity.js +28 -31
  64. package/dist/lib/sandbox/control/executor.js +149 -14
  65. package/dist/lib/sandbox/control/lifecycle.js +621 -127
  66. package/dist/lib/sandbox/control/native-file-lock.js +177 -0
  67. package/dist/lib/sandbox/control/server.js +305 -35
  68. package/dist/lib/sandbox/control/state.js +5 -3
  69. package/dist/lib/sandbox/control/task-view.js +183 -0
  70. package/dist/lib/sandbox/engines/authority.js +289 -0
  71. package/dist/lib/sandbox/engines/docker-exact-discovery.js +97 -0
  72. package/dist/lib/sandbox/index.js +5 -0
  73. package/dist/lib/sandbox/recovery.js +21 -1
  74. package/dist/lib/sandbox/workspace-view.js +2 -1
  75. package/dist/lib/sandbox/worktree-safety.js +4 -1
  76. package/dist/lib/server/index.js +8 -0
  77. package/dist/lib/task/artifact-lifecycle.js +42 -13
  78. package/dist/lib/task/artifact-operations.js +520 -0
  79. package/dist/lib/task/artifact-repair-intent.js +59 -0
  80. package/dist/lib/task/artifact-schema.js +135 -0
  81. package/dist/lib/task/capabilities.js +72 -1
  82. package/dist/lib/task/control-authority.js +4 -0
  83. package/dist/lib/task/create-service.js +103 -4
  84. package/dist/lib/task/create.js +25 -0
  85. package/dist/lib/task/events.js +186 -67
  86. package/dist/lib/task/index.js +11 -3
  87. package/dist/lib/task/local-artifact-finalization.js +75 -150
  88. package/dist/lib/task/orchestration.js +192 -52
  89. package/dist/lib/task/qualification-audit.js +490 -0
  90. package/dist/lib/task/qualification-confirmation.js +109 -0
  91. package/dist/lib/task/qualification-intents.js +148 -0
  92. package/dist/lib/task/review-artifacts.js +22 -23
  93. package/dist/lib/task/review-finalization.js +121 -4
  94. package/dist/lib/task/sections.js +6 -4
  95. package/dist/lib/task/verification-config.js +11 -0
  96. package/dist/lib/task/verification-engine.js +54 -4
  97. package/dist/lifecycle-build-manifest.json +3 -3
  98. package/lib/agent-client.ts +9 -0
  99. package/lib/internal/agent-client.ts +4 -2
  100. package/lib/internal/cli-route-inventory.ts +140 -0
  101. package/lib/internal/codex-lifecycle.ts +8 -6
  102. package/lib/internal/codex-sandbox-controller.ts +7 -2
  103. package/lib/internal/git-workflow.ts +9 -6
  104. package/lib/internal/platform-checks.ts +12 -4
  105. package/lib/internal/platform-comment.ts +12 -4
  106. package/lib/internal/platform-context.ts +3 -1
  107. package/lib/internal/platform-issue.ts +11 -4
  108. package/lib/internal/platform-metadata.ts +70 -0
  109. package/lib/internal/platform-pr-review.ts +14 -3
  110. package/lib/internal/platform-pr.ts +23 -10
  111. package/lib/internal/platform-release-notes.ts +5 -3
  112. package/lib/internal/platform-security.ts +83 -0
  113. package/lib/internal/pr-review-grade.ts +10 -3
  114. package/lib/internal/release-workflow.ts +17 -5
  115. package/lib/internal/sandbox-control.ts +19 -5
  116. package/lib/internal/task-activity.ts +12 -4
  117. package/lib/internal/task-artifact.ts +164 -25
  118. package/lib/internal/task-context.ts +3 -1
  119. package/lib/internal/task-create.ts +76 -15
  120. package/lib/internal/task-delivery.ts +3 -1
  121. package/lib/internal/task-event.ts +3 -1
  122. package/lib/internal/task-finalization.ts +3 -1
  123. package/lib/internal/task-invalidation.ts +3 -1
  124. package/lib/internal/task-ledger.ts +11 -1
  125. package/lib/internal/task-lifecycle.ts +3 -1
  126. package/lib/internal/task-operation-registry.ts +482 -0
  127. package/lib/internal/task-orchestration.ts +12 -0
  128. package/lib/internal/task-override.ts +9 -3
  129. package/lib/internal/task-qualification.ts +61 -0
  130. package/lib/internal/task-review.ts +3 -1
  131. package/lib/internal/task-short-id.ts +10 -1
  132. package/lib/internal/task-snapshot.ts +3 -1
  133. package/lib/internal/task-validate.ts +6 -2
  134. package/lib/internal/task-verify.ts +4 -1
  135. package/lib/internal/task-warning.ts +7 -1
  136. package/lib/platform/comment-safety.ts +250 -0
  137. package/lib/platform/github-provider.ts +229 -7
  138. package/lib/platform/issue-comments.ts +160 -35
  139. package/lib/platform/pr-change-report.ts +6 -12
  140. package/lib/platform/pr-summary.ts +27 -6
  141. package/lib/platform/provider-contract.ts +78 -3
  142. package/lib/platform/provider-validation.ts +85 -3
  143. package/lib/platform/pull-requests.ts +126 -178
  144. package/lib/platform/repository-metadata.ts +453 -0
  145. package/lib/platform/security-alerts.ts +191 -0
  146. package/lib/platform/verification-sync.ts +32 -28
  147. package/lib/process-data/index.ts +7 -0
  148. package/lib/run/index.ts +5 -0
  149. package/lib/sandbox/commands/control-status.ts +26 -0
  150. package/lib/sandbox/commands/create.ts +46 -6
  151. package/lib/sandbox/commands/ls.ts +7 -0
  152. package/lib/sandbox/commands/rm.ts +1000 -87
  153. package/lib/sandbox/commands/show.ts +16 -0
  154. package/lib/sandbox/control/client.ts +103 -9
  155. package/lib/sandbox/control/completed-reentry.ts +98 -0
  156. package/lib/sandbox/control/container-identity.ts +27 -43
  157. package/lib/sandbox/control/executor.ts +177 -12
  158. package/lib/sandbox/control/lifecycle.ts +629 -17
  159. package/lib/sandbox/control/native-file-lock.ts +209 -0
  160. package/lib/sandbox/control/protocol.ts +5 -2
  161. package/lib/sandbox/control/server.ts +319 -37
  162. package/lib/sandbox/control/state.ts +6 -3
  163. package/lib/sandbox/control/task-view.ts +240 -0
  164. package/lib/sandbox/engines/authority.ts +365 -0
  165. package/lib/sandbox/engines/docker-exact-discovery.ts +132 -0
  166. package/lib/sandbox/index.ts +7 -0
  167. package/lib/sandbox/recovery.ts +21 -1
  168. package/lib/sandbox/workspace-view.ts +9 -3
  169. package/lib/sandbox/worktree-safety.ts +4 -1
  170. package/lib/server/index.ts +10 -0
  171. package/lib/task/artifact-lifecycle.ts +38 -16
  172. package/lib/task/artifact-operations.ts +626 -0
  173. package/lib/task/artifact-repair-intent.ts +71 -0
  174. package/lib/task/artifact-schema.ts +192 -0
  175. package/lib/task/capabilities.ts +70 -1
  176. package/lib/task/control-authority.ts +11 -1
  177. package/lib/task/create-service.ts +131 -6
  178. package/lib/task/create.ts +27 -0
  179. package/lib/task/events.ts +161 -65
  180. package/lib/task/index.ts +16 -3
  181. package/lib/task/local-artifact-finalization.ts +87 -218
  182. package/lib/task/orchestration.ts +172 -49
  183. package/lib/task/qualification-audit.ts +599 -0
  184. package/lib/task/qualification-confirmation.ts +117 -0
  185. package/lib/task/qualification-intents.ts +150 -0
  186. package/lib/task/review-artifacts.ts +21 -22
  187. package/lib/task/review-finalization.ts +133 -4
  188. package/lib/task/sections.ts +6 -4
  189. package/lib/task/verification-config.ts +12 -0
  190. package/lib/task/verification-engine.ts +55 -4
  191. package/package.json +6 -1
  192. package/templates/.agents/rules/README.en.md +2 -0
  193. package/templates/.agents/rules/README.zh-CN.md +2 -0
  194. package/templates/.agents/rules/decision-qualification.en.md +22 -0
  195. package/templates/.agents/rules/decision-qualification.zh-CN.md +22 -0
  196. package/templates/.agents/rules/evidence-reporting.en.md +28 -0
  197. package/templates/.agents/rules/evidence-reporting.zh-CN.md +28 -0
  198. package/templates/.agents/rules/label-milestone-setup.en.md +7 -7
  199. package/templates/.agents/rules/label-milestone-setup.zh-CN.md +7 -7
  200. package/templates/.agents/rules/local-artifact-repair.en.md +5 -1
  201. package/templates/.agents/rules/local-artifact-repair.zh-CN.md +5 -1
  202. package/templates/.agents/rules/security-alerts.en.md +8 -8
  203. package/templates/.agents/rules/security-alerts.zh-CN.md +8 -8
  204. package/templates/.agents/skills/analyze-task/SKILL.en.md +15 -2
  205. package/templates/.agents/skills/analyze-task/SKILL.zh-CN.md +19 -2
  206. package/templates/.agents/skills/analyze-task/config/verify.en.json +1 -12
  207. package/templates/.agents/skills/analyze-task/config/verify.zh-CN.json +1 -12
  208. package/templates/.agents/skills/close-codescan/SKILL.en.md +2 -2
  209. package/templates/.agents/skills/close-codescan/SKILL.zh-CN.md +2 -2
  210. package/templates/.agents/skills/close-dependabot/SKILL.en.md +2 -2
  211. package/templates/.agents/skills/close-dependabot/SKILL.zh-CN.md +2 -2
  212. package/templates/.agents/skills/code-task/SKILL.en.md +14 -1
  213. package/templates/.agents/skills/code-task/SKILL.zh-CN.md +14 -1
  214. package/templates/.agents/skills/code-task/config/verify.en.json +5 -14
  215. package/templates/.agents/skills/code-task/config/verify.zh-CN.json +5 -14
  216. package/templates/.agents/skills/code-task/reference/code-rules.en.md +5 -4
  217. package/templates/.agents/skills/code-task/reference/code-rules.zh-CN.md +5 -4
  218. package/templates/.agents/skills/code-task/reference/dual-mode.en.md +1 -1
  219. package/templates/.agents/skills/code-task/reference/dual-mode.zh-CN.md +1 -1
  220. package/templates/.agents/skills/code-task/reference/fix-mode.en.md +3 -1
  221. package/templates/.agents/skills/code-task/reference/fix-mode.zh-CN.md +3 -1
  222. package/templates/.agents/skills/code-task/reference/report-template.en.md +42 -15
  223. package/templates/.agents/skills/code-task/reference/report-template.zh-CN.md +39 -12
  224. package/templates/.agents/skills/complete-manual-validation/SKILL.en.md +5 -1
  225. package/templates/.agents/skills/complete-manual-validation/SKILL.zh-CN.md +5 -1
  226. package/templates/.agents/skills/complete-manual-validation/reference/report-template.en.md +2 -0
  227. package/templates/.agents/skills/complete-manual-validation/reference/report-template.zh-CN.md +2 -0
  228. package/templates/.agents/skills/complete-task/SKILL.en.md +9 -22
  229. package/templates/.agents/skills/complete-task/SKILL.zh-CN.md +9 -22
  230. package/templates/.agents/skills/create-task/SKILL.en.md +8 -0
  231. package/templates/.agents/skills/create-task/SKILL.zh-CN.md +7 -0
  232. package/templates/.agents/skills/import-codescan/SKILL.en.md +1 -1
  233. package/templates/.agents/skills/import-codescan/SKILL.zh-CN.md +1 -1
  234. package/templates/.agents/skills/import-dependabot/SKILL.en.md +1 -1
  235. package/templates/.agents/skills/import-dependabot/SKILL.zh-CN.md +1 -1
  236. package/templates/.agents/skills/init-labels/SKILL.en.md +8 -8
  237. package/templates/.agents/skills/init-labels/SKILL.zh-CN.md +8 -8
  238. package/templates/.agents/skills/init-milestones/SKILL.en.md +9 -11
  239. package/templates/.agents/skills/init-milestones/SKILL.zh-CN.md +9 -11
  240. package/templates/.agents/skills/plan-task/SKILL.en.md +14 -1
  241. package/templates/.agents/skills/plan-task/SKILL.zh-CN.md +16 -1
  242. package/templates/.agents/skills/plan-task/config/verify.en.json +4 -14
  243. package/templates/.agents/skills/plan-task/config/verify.zh-CN.json +4 -14
  244. package/templates/.agents/skills/review-analysis/SKILL.en.md +14 -1
  245. package/templates/.agents/skills/review-analysis/SKILL.zh-CN.md +14 -1
  246. package/templates/.agents/skills/review-analysis/config/verify.en.json +1 -18
  247. package/templates/.agents/skills/review-analysis/config/verify.zh-CN.json +1 -18
  248. package/templates/.agents/skills/review-analysis/reference/report-template.en.md +50 -23
  249. package/templates/.agents/skills/review-analysis/reference/report-template.zh-CN.md +45 -18
  250. package/templates/.agents/skills/review-code/SKILL.en.md +14 -1
  251. package/templates/.agents/skills/review-code/SKILL.zh-CN.md +14 -1
  252. package/templates/.agents/skills/review-code/config/verify.en.json +1 -23
  253. package/templates/.agents/skills/review-code/config/verify.zh-CN.json +1 -23
  254. package/templates/.agents/skills/review-code/reference/report-template.en.md +49 -22
  255. package/templates/.agents/skills/review-code/reference/report-template.zh-CN.md +45 -18
  256. package/templates/.agents/skills/review-plan/SKILL.en.md +14 -1
  257. package/templates/.agents/skills/review-plan/SKILL.zh-CN.md +14 -1
  258. package/templates/.agents/skills/review-plan/config/verify.en.json +1 -18
  259. package/templates/.agents/skills/review-plan/config/verify.zh-CN.json +1 -18
  260. package/templates/.agents/skills/review-plan/reference/report-template.en.md +49 -22
  261. package/templates/.agents/skills/review-plan/reference/report-template.zh-CN.md +45 -18
  262. package/templates/.agents/skills/review-pr/SKILL.en.md +5 -1
  263. package/templates/.agents/skills/review-pr/SKILL.zh-CN.md +5 -1
  264. package/templates/.agents/skills/review-pr/reference/report-template.en.md +4 -3
  265. package/templates/.agents/skills/review-pr/reference/report-template.zh-CN.md +4 -3
  266. package/templates/.agents/skills/run-manual-validation/SKILL.en.md +5 -1
  267. package/templates/.agents/skills/run-manual-validation/SKILL.zh-CN.md +5 -1
  268. package/templates/.agents/skills/run-manual-validation/reference/report-template.en.md +3 -1
  269. package/templates/.agents/skills/run-manual-validation/reference/report-template.zh-CN.md +3 -1
  270. package/templates/.agents/skills/test/SKILL.en.md +13 -2
  271. package/templates/.agents/skills/test/SKILL.zh-CN.md +13 -2
  272. package/templates/.agents/skills/update-agent-infra/scripts/sync-templates.js +14 -0
  273. package/templates/.agents/templates/task.en.md +6 -0
  274. package/templates/.agents/templates/task.zh-CN.md +6 -0
  275. package/templates/.agents/scripts/security-alerts.github.sh +0 -151
  276. package/templates/.agents/scripts/security-alerts.sh +0 -31
  277. package/templates/.agents/skills/init-labels/scripts/init-labels.github.sh +0 -146
  278. package/templates/.agents/skills/init-labels/scripts/init-labels.sh +0 -32
  279. package/templates/.agents/skills/init-milestones/scripts/init-milestones.github.sh +0 -294
  280. package/templates/.agents/skills/init-milestones/scripts/init-milestones.sh +0 -6
@@ -1,5 +1,7 @@
1
1
  # Review Report Template
2
2
 
3
+ > Before writing this report, use `task-artifact init --family review-analysis` to create the skeleton and preserve every `artifact-section` marker; the skeleton contains no review conclusion.
4
+
3
5
  Use this template when writing `review-analysis.md` or `review-analysis-r{N}.md`.
4
6
 
5
7
  ## Output Template
@@ -12,11 +14,31 @@ Use this template when writing `review-analysis.md` or `review-analysis-r{N}.md`
12
14
  - **Review Input**:
13
15
  - `{analysis-artifact}` (the highest-round requirement-analysis artifact actually reviewed, e.g. `analysis-r2.md`; leave blank if it cannot be reliably determined)
14
16
 
15
- ## State Check
17
+ ## Review Summary
16
18
 
17
- > Paste the raw state-check command output; each command starts with `$ `.
19
+ ## Qualification Audit Review
18
20
 
19
- ## Review Summary
21
+ > Use `.agents/rules/decision-qualification.md` to review the five tables: constraint dependencies, candidate qualification, classification results, upstream relations, and dependency snapshot.
22
+
23
+ ### Constraint Dependencies
24
+ | constraint_id | constraint_digest | role | evidence |
25
+ | --- | --- | --- | --- |
26
+
27
+ ### Candidate Qualification
28
+ | candidate_id | status | impact | constraint_ids | evidence |
29
+ | --- | --- | --- | --- | --- |
30
+
31
+ ### Classification Results
32
+ | decision_id | classification | evidence |
33
+ | --- | --- | --- |
34
+
35
+ ### Upstream Relations
36
+ | upstream_family | upstream_artifact | upstream_round | upstream_sha256 | relation |
37
+ | --- | --- | --- | --- | --- |
38
+
39
+ ### Dependency Snapshot
40
+ | task_input_digest | non_constraint_input_digest | upstream_artifact_digest |
41
+ | --- | --- | --- |
20
42
 
21
43
  - **Reviewer**: {reviewer-name}
22
44
  - **Review Time**: {timestamp}
@@ -24,7 +46,7 @@ Use this template when writing `review-analysis.md` or `review-analysis-r{N}.md`
24
46
  - **Overall Verdict**: {Approved / Changes Requested / Rejected}
25
47
  - **Findings (AI-actionable)**: {unresolved-blockers} blockers, {unresolved-major} majors, {unresolved-minor} minors / **Manual validation**: 0
26
48
 
27
- ## Review Coverage Declaration
49
+ ## Inspection Coverage
28
50
 
29
51
  | pass_id | scope | evidence | result | gaps_or_assumptions |
30
52
  |---------|-------|----------|--------|---------------------|
@@ -34,7 +56,7 @@ Use this template when writing `review-analysis.md` or `review-analysis-r{N}.md`
34
56
  |---------|------------------|--------|--------|
35
57
  | {registry token} | {trigger or non-trigger evidence} | {yes / no / not-applicable} | {lens result} |
36
58
 
37
- ## Requirement Analysis Coverage
59
+ ## Requirements Analysis Coverage
38
60
 
39
61
  | perspective_id | applicability | reviewed_scope | evidence | result_or_gap |
40
62
  |----------------|---------------|----------------|----------|---------------|
@@ -92,7 +114,7 @@ Use this template when writing `review-analysis.md` or `review-analysis-r{N}.md`
92
114
  **File**: `{file-path}:{line-number}`
93
115
  **Suggestion**: {improvement suggestion}
94
116
 
95
- ## Non-blocking Advisories
117
+ ## Non-blocking Suggestions
96
118
 
97
119
  > Record only future optimizations that do not affect the current artifact's completeness, correctness, or acceptance. Advisories do not enter the disagreement ledger, finding counts, or verdict.
98
120
 
@@ -111,27 +133,42 @@ Use this template when writing `review-analysis.md` or `review-analysis-r{N}.md`
111
133
  > If this round has no Manual validation items, keep the section heading and write "None".
112
134
 
113
135
 
114
- ## Review Disagreement Ledger Writeback
136
+ ## Conclusion and Recommendation
115
137
 
116
- > Record the structured intents to submit: use `task-ledger finding-upsert` for new findings and `finding-review` for prior responses. The core allocates `AN-N` and validates transitions; do not edit task.md table rows.
117
- > Every finding escalated to `needs-human-decision` must include a self-contained detail block per `.agents/rules/human-decision-context.md`, with evidence pointing to that stable anchor.
138
+ ### Approval Decision
139
+ - [ ] Approved
140
+ - [ ] Changes Requested
141
+ - [ ] Rejected
142
+
143
+ ### Next Steps
144
+ {recommended next step}
145
+
146
+ ## State Check
118
147
 
119
- ## Evidence
148
+ > Record the state-check command, review scope, key result, and uncovered parts; each command starts with `$ `.
149
+ > Follow `.agents/rules/evidence-reporting.md`: record review scope, key result, and uncovered parts; do not paste complete successful stdout.
120
150
 
121
- > Pair each "I verified X" claim with the corresponding raw tool output; the gate only checks that this section exists and at least one `$ ` line is present. Every Blocker must be backed by a reproducible command (rg/grep/sed/nl) and its raw output; a judgment that cannot be reproduced must be downgraded or moved to Self-Doubt.
151
+ ## Raw Evidence
152
+
153
+ > Follow `.agents/rules/evidence-reporting.md`: pair each claim with a `$ ` command and proportionate result summary; Blockers, failures, blocking conditions, or disputes require a reproducible command, exact location, and decisive excerpt; a judgment that cannot be reproduced must be downgraded or moved to Self-Doubt.
122
154
 
123
155
  - Claim: {verified claim}
124
156
  ```text
125
157
  $ {command}
126
- {raw output}
158
+ {result summary or decisive excerpt}
127
159
  ```
128
160
 
129
- ## Self-Doubt
161
+ ## Self-critique
130
162
 
131
163
  > Explicitly declare conclusions, inferences, and assumptions in this review that were **not directly verified**; downstream can rebut them on this basis. Write "None" if there are none.
132
164
 
133
165
  - {an unverified conclusion or inference; note why it was not verified and the impact if it is overturned}
134
166
 
167
+ ## Review Disagreement Ledger Write-back
168
+
169
+ > Record the structured intents to submit: use `task-ledger finding-upsert` for new findings and `finding-review` for prior responses. The core allocates `AN-N` and validates transitions; do not edit task.md table rows.
170
+ > Every finding escalated to `needs-human-decision` must include a self-contained detail block per `.agents/rules/human-decision-context.md`, with evidence pointing to that stable anchor.
171
+
135
172
  ## Highlights
136
173
 
137
174
  - {what went well}
@@ -140,14 +177,4 @@ $ {command}
140
177
 
141
178
  - [ ] Implementation matches the technical plan
142
179
  - [ ] No unintended scope expansion
143
-
144
- ## Conclusion and Recommendation
145
-
146
- ### Approval Decision
147
- - [ ] Approved
148
- - [ ] Changes Requested
149
- - [ ] Rejected
150
-
151
- ### Next Steps
152
- {recommended next step}
153
180
  ```
@@ -1,5 +1,7 @@
1
1
  # 审查报告模板
2
2
 
3
+ > 写入本报告前,先用 `task-artifact init --family review-analysis` 创建骨架,并保留每个 `artifact-section` marker;骨架不包含审查结论。
4
+
3
5
  编写 `review-analysis.md` 或 `review-analysis-r{N}.md` 时使用本模板。
4
6
 
5
7
  ## 输出模板
@@ -12,11 +14,31 @@
12
14
  - **审查输入**:
13
15
  - `{analysis-artifact}`(本轮实际检视的最高轮需求分析产物,如 `analysis-r2.md`;无法可靠取得则留空)
14
16
 
15
- ## 状态核对
17
+ ## 审查摘要
16
18
 
17
- > 粘贴状态核对命令原文;每条命令以 `$ ` 开头。
19
+ ## 资格审计复核
18
20
 
19
- ## 审查摘要
21
+ > 按 `.agents/rules/decision-qualification.md` 复核:约束依赖、候选资格、分类结果、上游关系和依赖快照五张表。
22
+
23
+ ### 约束依赖
24
+ | constraint_id | constraint_digest | role | evidence |
25
+ | --- | --- | --- | --- |
26
+
27
+ ### 候选资格
28
+ | candidate_id | status | impact | constraint_ids | evidence |
29
+ | --- | --- | --- | --- | --- |
30
+
31
+ ### 分类结果
32
+ | decision_id | classification | evidence |
33
+ | --- | --- | --- |
34
+
35
+ ### 上游关系
36
+ | upstream_family | upstream_artifact | upstream_round | upstream_sha256 | relation |
37
+ | --- | --- | --- | --- | --- |
38
+
39
+ ### 依赖快照
40
+ | task_input_digest | non_constraint_input_digest | upstream_artifact_digest |
41
+ | --- | --- | --- |
20
42
 
21
43
  - **审查者**:{reviewer-name}
22
44
  - **审查时间**:{timestamp}
@@ -111,19 +133,29 @@
111
133
  > 如本轮无人工校验项,保留段落标题并写「(无)」。
112
134
 
113
135
 
114
- ## 审查分歧账本回写
136
+ ## 结论与建议
115
137
 
116
- > 本段记录将提交的结构化意图:新 finding 用 `task-ledger finding-upsert`,上一轮响应复核用 `finding-review`;由核心分配 `AN-N` 并校验状态机,禁止手写 task.md 表格。
117
- > 凡升级为 `needs-human-decision` 的 finding,必须按 `.agents/rules/human-decision-context.md` 在本报告中提供自足详情块,并让 evidence 指向该稳定锚点。
138
+ ### 审查决定
139
+ - [ ] 通过
140
+ - [ ] 需要修改
141
+ - [ ] 拒绝
142
+
143
+ ### 下一步
144
+ {recommended next step}
145
+
146
+ ## 状态核对
147
+
148
+ > 记录状态核对命令、审查范围、关键结果和未覆盖部分;每条命令以 `$ ` 开头。
149
+ > 按 `.agents/rules/evidence-reporting.md` 同时记录审查范围、关键结果和未覆盖部分;正常成功不粘贴完整 stdout。
118
150
 
119
151
  ## 证据原文
120
152
 
121
- > 每条“我验证了 X”断言都要配对对应 tool output 原文;gate 仅校验本段存在和至少一行 `$ `。每条 Blocker 必须配可复现命令(rg/grep/sed/nl)及其原文;无法复现的判断须降级或移入「自我质疑」。
153
+ > 遵循 `.agents/rules/evidence-reporting.md`:每条断言配对 `$ ` 命令和相称结果摘要;Blocker、失败、阻塞或争议必须保留可复现命令、准确位置和决定性摘录;无法复现的判断须降级或移入「自我质疑」。
122
154
 
123
155
  - 断言:{verified claim}
124
156
  ```text
125
157
  $ {command}
126
- {raw output}
158
+ {result summary or decisive excerpt}
127
159
  ```
128
160
 
129
161
  ## 自我质疑
@@ -132,6 +164,11 @@ $ {command}
132
164
 
133
165
  - {未直接验证的结论或推断;说明为何未验证、若被推翻的影响}
134
166
 
167
+ ## 审查分歧账本回写
168
+
169
+ > 本段记录将提交的结构化意图:新 finding 用 `task-ledger finding-upsert`,上一轮响应复核用 `finding-review`;由核心分配 `AN-N` 并校验状态机,禁止手写 task.md 表格。
170
+ > 凡升级为 `needs-human-decision` 的 finding,必须按 `.agents/rules/human-decision-context.md` 在本报告中提供自足详情块,并让 evidence 指向该稳定锚点。
171
+
135
172
  ## 亮点
136
173
 
137
174
  - {what went well}
@@ -140,14 +177,4 @@ $ {command}
140
177
 
141
178
  - [ ] 实现与技术方案一致
142
179
  - [ ] 没有意外的范围扩张
143
-
144
- ## 结论与建议
145
-
146
- ### 审查决定
147
- - [ ] 通过
148
- - [ ] 需要修改
149
- - [ ] 拒绝
150
-
151
- ### 下一步
152
- {recommended next step}
153
180
  ```
@@ -15,6 +15,11 @@ Review the latest code round and produce `review-code.md` or `review-code-r{N}.m
15
15
 
16
16
  ## Boundary / Critical Rules
17
17
 
18
+ ### Persisted Report Evidence
19
+
20
+ Before generating the review report, read `.agents/rules/evidence-reporting.md`. Normal inspection records the command, scope, structured result, actual conclusion, and uncovered parts; findings, blocking conditions, or disputes retain reproducible locations and decisive excerpts, while identity fields remain exact.
21
+
22
+ - When reviewing candidate qualification or `HD-N`, read `.agents/rules/decision-qualification.md` and check the five qualification-audit tables, digests, QCR, and upstream relations; do not treat a process label as identity authentication
18
23
  - This skill reviews code and writes a report; it does not modify product code
19
24
  - Before generating task or lifecycle Markdown that will be synchronized to an Issue, read `.agents/rules/sync-content-generation.md` and apply its producer-side constraints; the sync path does not parse or rewrite the body
20
25
  - After executing this skill, you **must** immediately update task.md
@@ -34,7 +39,7 @@ Version stamp rule: when creating or updating `task.md` frontmatter, read `.agen
34
39
 
35
40
  After loading workflow / skill / rules instructions, and before any task-state judgment or user-visible conclusion, run the state check first. Reading instruction files does not count as an external-state action or conclusion.
36
41
 
37
- Run these commands and paste the raw output into this round's `## State Check` section:
42
+ Run these commands and record the task/artifact scope, key result, and uncovered parts in this round's `## State Check` section; do not paste complete directory listings or task tails on normal success. Retain decisive raw lines only for failures, blocking conditions, identity mismatches, or disputes:
38
43
 
39
44
  ```bash
40
45
  agent-infra-internal task-snapshot {task-id} --format text
@@ -91,6 +96,14 @@ Complete the code implementation coverage in `reference/report-template.md`. App
91
96
 
92
97
  ### 5. Write the Review Report
93
98
 
99
+ Before writing this round's `{review-artifact}`, create the controlled review skeleton:
100
+
101
+ ```bash
102
+ agent-infra-internal task-artifact {task-id} init --family review-code --artifact {review-artifact} --locale en
103
+ ```
104
+
105
+ The skeleton does not generate a verdict, findings, or counts; complete review content is required before summary finalization. If structural finalization returns one provably safe error, call `task-artifact {task-id} repair --family review-code --artifact {review-artifact} --expected-sha256 {artifact-sha256} --expected-semantic-digest {semantic-digest}`, then rerun the original finalizer.
106
+
94
107
  Create `.agents/workspace/active/{task-id}/{review-artifact}`.
95
108
 
96
109
  > The report format and severity layout live in `reference/report-template.md`. Read `reference/report-template.md` before writing the review.
@@ -15,6 +15,11 @@ description: >
15
15
 
16
16
  ## 行为边界 / 关键规则
17
17
 
18
+ ### 持久化报告证据
19
+
20
+ 生成审查报告时,先读取 `.agents/rules/evidence-reporting.md`。正常检视记录命令、范围、结构化结果、实际结论和未覆盖部分;finding、阻塞或争议保留可复现位置与决定性摘录,身份字段必须精确保留。
21
+
22
+ - 审查候选资格或 `HD-N` 判断时,先读取 `.agents/rules/decision-qualification.md`,逐项复核产物中的五张资格审计表、digest、QCR 和上游关系;不得把流程标签当作身份认证
18
23
  - 本技能只审查代码并写报告,不修改业务代码
19
24
  - 生成会同步到 Issue 的任务或生命周期 Markdown 前,先读取 `.agents/rules/sync-content-generation.md` 并遵循其中的生成端约束;同步端不解析或改写正文
20
25
  - 执行本技能后,你**必须**立即更新 task.md
@@ -34,7 +39,7 @@ description: >
34
39
 
35
40
  在加载 workflow / skill / rules 指令之后、做任何任务状态判断或用户可见结论之前,必须先执行状态核对。指令类文件读取不算对外动作或结论。
36
41
 
37
- 运行以下命令,并把原文粘贴到本轮产物的 `## 状态核对` 段:
42
+ 运行以下命令,并在本轮产物的 `## 状态核对` 段记录任务/产物范围、关键结果和未覆盖部分;正常成功不粘贴完整目录清单或 `task.md` 尾部。失败、阻塞、身份不一致或争议时,附决定性原文行:
38
43
 
39
44
  ```bash
40
45
  agent-infra-internal task-snapshot {task-id} --format text
@@ -90,6 +95,14 @@ agent-infra-internal task-snapshot {task-id} --format text
90
95
 
91
96
  ### 5. 编写审查报告
92
97
 
98
+ 在首次写入本轮 `{review-artifact}` 前,先创建受控审查骨架:
99
+
100
+ ```bash
101
+ agent-infra-internal task-artifact {task-id} init --family review-code --artifact {review-artifact}
102
+ ```
103
+
104
+ 骨架不生成审查结论、发现或计数;完成审查内容后才能进入 summary finalizer。结构 finalizer 返回可证明的单个错误时,使用其 SHA 和 semantic digest 调用 `task-artifact {task-id} repair --family review-code --artifact {review-artifact} --expected-sha256 {artifact-sha256} --expected-semantic-digest {semantic-digest}`,再重跑原 finalizer。
105
+
93
106
  创建 `.agents/workspace/active/{task-id}/{review-artifact}`。
94
107
 
95
108
  > 报告格式和严重程度布局见 `reference/report-template.md`。写报告前先读取 `reference/report-template.md`。
@@ -17,29 +17,7 @@
17
17
  },
18
18
  "artifact": {
19
19
  "file_pattern": "review-code.md|review-code-r{N}.md",
20
- "required_sections": [
21
- "Review Summary",
22
- "Review Coverage Declaration",
23
- "Code Implementation Coverage",
24
- "Traceability Matrix",
25
- "Findings",
26
- "Non-blocking Advisories",
27
- "Manual Validation Items",
28
- "Conclusion and Recommendations",
29
- "State Check",
30
- "Evidence",
31
- "Self-Doubt",
32
- "Review Disagreement Ledger Writeback"
33
- ],
34
- "required_patterns": [
35
- "^### Approval Decision$",
36
- "^\\$ ",
37
- "^- \\*\\*Overall Verdict\\*\\*[::]\\s*(?:通过|需要修改|拒绝|Approved|Changes Requested|Rejected)\\s*$",
38
- "^- \\*\\*Review Baseline Commit\\*\\*[::]\\s*\\S",
39
- "^- \\*\\*Reviewed Diff Base\\*\\*[::]\\s*[0-9a-f]{40,64}\\s*$",
40
- "^- \\*\\*Reviewed Diff Fingerprint\\*\\*[::]\\s*sha256:[0-9a-f]{64}\\s*$",
41
- "^- \\*\\*Reviewed Snapshot Tree\\*\\*[::]\\s*[0-9a-f]{40,64}\\s*$"
42
- ]
20
+ "schema": "review-code"
43
21
  },
44
22
  "decision-details": {},
45
23
  "review-summary": {
@@ -17,29 +17,7 @@
17
17
  },
18
18
  "artifact": {
19
19
  "file_pattern": "review-code.md|review-code-r{N}.md",
20
- "required_sections": [
21
- "审查摘要",
22
- "检视覆盖声明",
23
- "代码实现专项覆盖",
24
- "追踪矩阵",
25
- "问题清单",
26
- "非阻塞建议",
27
- "人工校验项",
28
- "结论与建议",
29
- "状态核对",
30
- "证据原文",
31
- "自我质疑",
32
- "审查分歧账本回写"
33
- ],
34
- "required_patterns": [
35
- "^### 审查决定$",
36
- "^\\$ ",
37
- "^- \\*\\*总体结论\\*\\*[::]\\s*(?:通过|需要修改|拒绝|Approved|Changes Requested|Rejected)\\s*$",
38
- "^- \\*\\*审查基线提交\\*\\*[::]\\s*\\S",
39
- "^- \\*\\*审查差异基线\\*\\*[::]\\s*[0-9a-f]{40,64}\\s*$",
40
- "^- \\*\\*审查差异指纹\\*\\*[::]\\s*sha256:[0-9a-f]{64}\\s*$",
41
- "^- \\*\\*审查快照树\\*\\*[::]\\s*[0-9a-f]{40,64}\\s*$"
42
- ]
20
+ "schema": "review-code"
43
21
  },
44
22
  "decision-details": {},
45
23
  "review-summary": {
@@ -1,5 +1,7 @@
1
1
  # Review Report Template
2
2
 
3
+ > Before writing this report, use `task-artifact init --family review-code` to create the skeleton and preserve every `artifact-section` marker; the skeleton contains no review conclusion.
4
+
3
5
  Use this template when writing `review-code.md` or `review-code-r{N}.md`.
4
6
 
5
7
  ## Output Template
@@ -12,11 +14,31 @@ Use this template when writing `review-code.md` or `review-code-r{N}.md`.
12
14
  - **Review Input**:
13
15
  - `{code-artifact}` (the highest-round implementation artifact actually reviewed—plus the highest-round fix artifact if present, e.g. `code-r2.md`; leave blank if it cannot be reliably determined)
14
16
 
15
- ## State Check
17
+ ## Review Summary
16
18
 
17
- > Paste the raw state-check command output; each command starts with `$ `.
19
+ ## Qualification Audit Review
18
20
 
19
- ## Review Summary
21
+ > Use `.agents/rules/decision-qualification.md` to review the five tables: constraint dependencies, candidate qualification, classification results, upstream relations, and dependency snapshot.
22
+
23
+ ### Constraint Dependencies
24
+ | constraint_id | constraint_digest | role | evidence |
25
+ | --- | --- | --- | --- |
26
+
27
+ ### Candidate Qualification
28
+ | candidate_id | status | impact | constraint_ids | evidence |
29
+ | --- | --- | --- | --- | --- |
30
+
31
+ ### Classification Results
32
+ | decision_id | classification | evidence |
33
+ | --- | --- | --- |
34
+
35
+ ### Upstream Relations
36
+ | upstream_family | upstream_artifact | upstream_round | upstream_sha256 | relation |
37
+ | --- | --- | --- | --- | --- |
38
+
39
+ ### Dependency Snapshot
40
+ | task_input_digest | non_constraint_input_digest | upstream_artifact_digest |
41
+ | --- | --- | --- |
20
42
 
21
43
  - **Reviewer**: {reviewer-name}
22
44
  - **Review Time**: {timestamp}
@@ -30,7 +52,7 @@ Use this template when writing `review-code.md` or `review-code-r{N}.md`.
30
52
  - **Overall Verdict**: {Approved / Changes Requested / Rejected} (pick exactly one; combined phrases will fail the verify gate)
31
53
  - **Findings (AI-actionable)**: {unresolved-blockers} blockers, {unresolved-major} majors, {unresolved-minor} minors / **Manual validation**: 0
32
54
 
33
- ## Review Coverage Declaration
55
+ ## Inspection Coverage
34
56
 
35
57
  | pass_id | scope | evidence | result | gaps_or_assumptions |
36
58
  |---------|-------|----------|--------|---------------------|
@@ -98,7 +120,7 @@ Use this template when writing `review-code.md` or `review-code-r{N}.md`.
98
120
  **File**: `{file-path}:{line-number}`
99
121
  **Suggestion**: {improvement suggestion}
100
122
 
101
- ## Non-blocking Advisories
123
+ ## Non-blocking Suggestions
102
124
 
103
125
  > Record only future optimizations that do not affect the current artifact's completeness, correctness, or acceptance. Advisories do not enter the disagreement ledger, finding counts, or verdict.
104
126
 
@@ -117,27 +139,42 @@ Use this template when writing `review-code.md` or `review-code-r{N}.md`.
117
139
  > If this round has no Manual validation items, keep the section heading and write "None".
118
140
 
119
141
 
120
- ## Review Disagreement Ledger Writeback
142
+ ## Conclusion and Recommendation
121
143
 
122
- > Record the structured intents to submit: use `task-ledger finding-upsert` for new findings and `finding-review` for prior responses. The core allocates `CD-N` and validates transitions; do not edit task.md table rows.
123
- > Every finding escalated to `needs-human-decision` must include a self-contained detail block per `.agents/rules/human-decision-context.md`, with evidence pointing to that stable anchor.
144
+ ### Approval Decision
145
+ - [ ] Approved
146
+ - [ ] Changes Requested
147
+ - [ ] Rejected
148
+
149
+ ### Next Steps
150
+ {recommended next step}
151
+
152
+ ## State Check
124
153
 
125
- ## Evidence
154
+ > Record the state-check command, review scope, key result, and uncovered parts; each command starts with `$ `.
155
+ > Follow `.agents/rules/evidence-reporting.md`: record review scope, key result, and uncovered parts; do not paste complete successful stdout.
126
156
 
127
- > Pair each "I verified X" claim with the corresponding raw tool output; the gate only checks that this section exists and at least one `$ ` line is present. Every Blocker must use reproducible test, call-chain, state-transition, data-flow, specification-conflict, or accurate-location evidence; a judgment that cannot be reproduced must be downgraded or moved to Self-Doubt.
157
+ ## Raw Evidence
158
+
159
+ > Follow `.agents/rules/evidence-reporting.md`: pair each claim with a `$ ` command and proportionate result summary; Blockers, failures, blocking conditions, or disputes require reproducible evidence, exact location, and a decisive excerpt; a judgment that cannot be reproduced must be downgraded or moved to Self-Doubt.
128
160
 
129
161
  - Claim: {verified claim}
130
162
  ```text
131
163
  $ {command}
132
- {raw output}
164
+ {result summary or decisive excerpt}
133
165
  ```
134
166
 
135
- ## Self-Doubt
167
+ ## Self-critique
136
168
 
137
169
  > Explicitly declare conclusions, inferences, and assumptions in this review that were **not directly verified**; downstream can rebut them on this basis. Write "None" if there are none.
138
170
 
139
171
  - {an unverified conclusion or inference; note why it was not verified and the impact if it is overturned}
140
172
 
173
+ ## Review Disagreement Ledger Write-back
174
+
175
+ > Record the structured intents to submit: use `task-ledger finding-upsert` for new findings and `finding-review` for prior responses. The core allocates `CD-N` and validates transitions; do not edit task.md table rows.
176
+ > Every finding escalated to `needs-human-decision` must include a self-contained detail block per `.agents/rules/human-decision-context.md`, with evidence pointing to that stable anchor.
177
+
141
178
  ## Highlights
142
179
 
143
180
  - {what went well}
@@ -146,14 +183,4 @@ $ {command}
146
183
 
147
184
  - [ ] Implementation matches the technical plan
148
185
  - [ ] No unintended scope expansion
149
-
150
- ## Conclusion and Recommendation
151
-
152
- ### Approval Decision
153
- - [ ] Approved
154
- - [ ] Changes Requested
155
- - [ ] Rejected
156
-
157
- ### Next Steps
158
- {recommended next step}
159
186
  ```
@@ -1,5 +1,7 @@
1
1
  # 审查报告模板
2
2
 
3
+ > 写入本报告前,先用 `task-artifact init --family review-code` 创建骨架,并保留每个 `artifact-section` marker;骨架不包含审查结论。
4
+
3
5
  编写 `review-code.md` 或 `review-code-r{N}.md` 时使用本模板。
4
6
 
5
7
  ## 输出模板
@@ -12,11 +14,31 @@
12
14
  - **审查输入**:
13
15
  - `{code-artifact}`(本轮实际检视的最高轮实现产物——含如存在的最高轮修复产物,如 `code-r2.md`;无法可靠取得则留空)
14
16
 
15
- ## 状态核对
17
+ ## 审查摘要
16
18
 
17
- > 粘贴状态核对命令原文;每条命令以 `$ ` 开头。
19
+ ## 资格审计复核
18
20
 
19
- ## 审查摘要
21
+ > 按 `.agents/rules/decision-qualification.md` 复核:约束依赖、候选资格、分类结果、上游关系和依赖快照五张表。
22
+
23
+ ### 约束依赖
24
+ | constraint_id | constraint_digest | role | evidence |
25
+ | --- | --- | --- | --- |
26
+
27
+ ### 候选资格
28
+ | candidate_id | status | impact | constraint_ids | evidence |
29
+ | --- | --- | --- | --- | --- |
30
+
31
+ ### 分类结果
32
+ | decision_id | classification | evidence |
33
+ | --- | --- | --- |
34
+
35
+ ### 上游关系
36
+ | upstream_family | upstream_artifact | upstream_round | upstream_sha256 | relation |
37
+ | --- | --- | --- | --- | --- |
38
+
39
+ ### 依赖快照
40
+ | task_input_digest | non_constraint_input_digest | upstream_artifact_digest |
41
+ | --- | --- | --- |
20
42
 
21
43
  - **审查者**:{reviewer-name}
22
44
  - **审查时间**:{timestamp}
@@ -117,19 +139,29 @@
117
139
  > 如本轮无人工校验项,保留段落标题并写「(无)」。
118
140
 
119
141
 
120
- ## 审查分歧账本回写
142
+ ## 结论与建议
121
143
 
122
- > 本段记录将提交的结构化意图:新 finding 用 `task-ledger finding-upsert`,上一轮响应复核用 `finding-review`;由核心分配 `CD-N` 并校验状态机,禁止手写 task.md 表格。
123
- > 凡升级为 `needs-human-decision` 的 finding,必须按 `.agents/rules/human-decision-context.md` 在本报告中提供自足详情块,并让 evidence 指向该稳定锚点。
144
+ ### 审查决定
145
+ - [ ] 通过
146
+ - [ ] 需要修改
147
+ - [ ] 拒绝
148
+
149
+ ### 下一步
150
+ {recommended next step}
151
+
152
+ ## 状态核对
153
+
154
+ > 记录状态核对命令、审查范围、关键结果和未覆盖部分;每条命令以 `$ ` 开头。
155
+ > 按 `.agents/rules/evidence-reporting.md` 同时记录审查范围、关键结果和未覆盖部分;正常成功不粘贴完整 stdout。
124
156
 
125
157
  ## 证据原文
126
158
 
127
- > 每条“我验证了 X”断言都要配对对应 tool output 原文;gate 仅校验本段存在和至少一行 `$ `。每条 Blocker 必须配可复现的测试、调用链、状态转换、数据流、规范冲突或准确位置证据;无法复现的判断须降级或移入「自我质疑」。
159
+ > 遵循 `.agents/rules/evidence-reporting.md`:每条断言配对 `$ ` 命令和相称结果摘要;Blocker、失败、阻塞或争议必须保留可复现证据、准确位置和决定性摘录;无法复现的判断须降级或移入「自我质疑」。
128
160
 
129
161
  - 断言:{verified claim}
130
162
  ```text
131
163
  $ {command}
132
- {raw output}
164
+ {result summary or decisive excerpt}
133
165
  ```
134
166
 
135
167
  ## 自我质疑
@@ -138,6 +170,11 @@ $ {command}
138
170
 
139
171
  - {未直接验证的结论或推断;说明为何未验证、若被推翻的影响}
140
172
 
173
+ ## 审查分歧账本回写
174
+
175
+ > 本段记录将提交的结构化意图:新 finding 用 `task-ledger finding-upsert`,上一轮响应复核用 `finding-review`;由核心分配 `CD-N` 并校验状态机,禁止手写 task.md 表格。
176
+ > 凡升级为 `needs-human-decision` 的 finding,必须按 `.agents/rules/human-decision-context.md` 在本报告中提供自足详情块,并让 evidence 指向该稳定锚点。
177
+
141
178
  ## 亮点
142
179
 
143
180
  - {what went well}
@@ -146,14 +183,4 @@ $ {command}
146
183
 
147
184
  - [ ] 实现与技术方案一致
148
185
  - [ ] 没有意外的范围扩张
149
-
150
- ## 结论与建议
151
-
152
- ### 审查决定
153
- - [ ] 通过
154
- - [ ] 需要修改
155
- - [ ] 拒绝
156
-
157
- ### 下一步
158
- {recommended next step}
159
186
  ```
@@ -15,6 +15,11 @@ Review the latest plan artifact and produce `review-plan.md` or `review-plan-r{N
15
15
 
16
16
  ## Boundary / Critical Rules
17
17
 
18
+ ### Persisted Report Evidence
19
+
20
+ Before generating the review report, read `.agents/rules/evidence-reporting.md`. Normal inspection records the command, scope, structured result, actual conclusion, and uncovered parts; findings, blocking conditions, or disputes retain reproducible locations and decisive excerpts, while identity fields remain exact.
21
+
22
+ - When reviewing candidate qualification or `HD-N`, read `.agents/rules/decision-qualification.md` and check the five qualification-audit tables, digests, QCR, and upstream relations; do not treat a process label as identity authentication
18
23
  - This skill only reviews plan artifacts and writes a report; it does not modify product code.
19
24
  - Before generating task or lifecycle Markdown that will be synchronized to an Issue, read `.agents/rules/sync-content-generation.md` and apply its producer-side constraints; the sync path does not parse or rewrite the body
20
25
  - After executing this skill, you **must** immediately update task.md.
@@ -25,7 +30,7 @@ Version stamp rule: when creating or updating `task.md` frontmatter, read `.agen
25
30
 
26
31
  After loading workflow / skill / rules instructions, and before any task-state judgment or user-visible conclusion, run the state check first.
27
32
 
28
- Run these commands and paste the raw output into this round's `## State Check` section:
33
+ Run these commands and record the task/artifact scope, key result, and uncovered parts in this round's `## State Check` section; do not paste complete directory listings or task tails on normal success. Retain decisive raw lines only for failures, blocking conditions, identity mismatches, or disputes:
29
34
 
30
35
  ```bash
31
36
  agent-infra-internal task-snapshot {task-id} --format text
@@ -64,6 +69,14 @@ Check simplicity, executability, risk control, test strategy, file coverage, and
64
69
 
65
70
  ### 5. Write Review Report
66
71
 
72
+ Before writing this round's `{review-artifact}`, create the controlled review skeleton:
73
+
74
+ ```bash
75
+ agent-infra-internal task-artifact {task-id} init --family review-plan --artifact {review-artifact} --locale en
76
+ ```
77
+
78
+ The skeleton contains identity metadata, stable section markers, and required headings only; complete review content is required before summary finalization. If structural finalization returns one provably safe error, call `task-artifact {task-id} repair --family review-plan --artifact {review-artifact} --expected-sha256 {artifact-sha256} --expected-semantic-digest {semantic-digest}`, then rerun the original finalizer.
79
+
67
80
  Create `.agents/workspace/active/{task-id}/{review-artifact}`.
68
81
 
69
82
  > Read `reference/report-template.md` before writing the report.