@fitlab-ai/agent-infra 0.9.13 → 0.9.14

package/templates/.agents/skills/review-plan/SKILL.zh-CN.md

@@ -15,6 +15,11 @@ description: >
 
 ## 行为边界 / 关键规则
 
+### 持久化报告证据
+
+生成审查报告时，先读取 `.agents/rules/evidence-reporting.md`。正常检视记录命令、范围、结构化结果、实际结论和未覆盖部分；finding、阻塞或争议保留可复现位置与决定性摘录，身份字段必须精确保留。
+
+- 审查候选资格或 `HD-N` 判断时，先读取 `.agents/rules/decision-qualification.md`，逐项复核产物中的五张资格审计表、digest、QCR 和上游关系；不得把流程标签当作身份认证
 - 本技能只审查方案产物并写报告，不修改业务代码
 - 生成会同步到 Issue 的任务或生命周期 Markdown 前，先读取 `.agents/rules/sync-content-generation.md` 并遵循其中的生成端约束；同步端不解析或改写正文
 - 执行本技能后，你**必须**立即更新 task.md
@@ -25,7 +30,7 @@ description: >
 
 在加载 workflow / skill / rules 指令之后、做任何任务状态判断或用户可见结论之前，必须先执行状态核对。指令类文件读取不算对外动作或结论。
 
-运行以下命令，并把原文粘贴到本轮产物的 `## 状态核对` 段：
+运行以下命令，并在本轮产物的 `## 状态核对` 段记录任务/产物范围、关键结果和未覆盖部分；正常成功不粘贴完整目录清单或 `task.md` 尾部。失败、阻塞、身份不一致或争议时，附决定性原文行：
 
 ```bash
 agent-infra-internal task-snapshot {task-id} --format text
@@ -67,6 +72,14 @@ agent-infra-internal task-snapshot {task-id} --format text
 
 ### 5. 编写审查报告
 
+在首次写入本轮 `{review-artifact}` 前，先创建受控审查骨架：
+
+```bash
+agent-infra-internal task-artifact {task-id} init --family review-plan --artifact {review-artifact}
+```
+
+骨架不生成审查结论、发现或计数；完成审查内容后才能进入 summary finalizer。结构 finalizer 返回可证明的单个错误时，使用其 SHA 和 semantic digest 调用 `task-artifact {task-id} repair --family review-plan --artifact {review-artifact} --expected-sha256 {artifact-sha256} --expected-semantic-digest {semantic-digest}`，再重跑原 finalizer。
+
 创建 `.agents/workspace/active/{task-id}/{review-artifact}`。
 
 > 报告格式见 `reference/report-template.md`。写报告前先读取 `reference/report-template.md`。

package/templates/.agents/skills/review-plan/config/verify.en.json

@@ -17,24 +17,7 @@
     },
     "artifact": {
       "file_pattern": "review-plan.md|review-plan-r{N}.md",
-      "required_sections": [
-        "Review Summary",
-        "Review Coverage Declaration",
-        "Technical Plan Architecture Coverage",
-        "Traceability Matrix",
-        "Findings",
-        "Non-blocking Advisories",
-        "Manual Validation Items",
-        "Conclusion and Recommendations",
-        "State Check",
-        "Evidence",
-        "Self-Doubt",
-        "Review Disagreement Ledger Writeback"
-      ],
-      "required_patterns": [
-        "^### Approval Decision$",
-        "^\\$ "
-      ]
+      "schema": "review-plan"
     },
     "decision-details": {},
     "review-summary": {

package/templates/.agents/skills/review-plan/config/verify.zh-CN.json

@@ -17,24 +17,7 @@
     },
     "artifact": {
       "file_pattern": "review-plan.md|review-plan-r{N}.md",
-      "required_sections": [
-        "审查摘要",
-        "检视覆盖声明",
-        "技术方案架构覆盖",
-        "追踪矩阵",
-        "问题清单",
-        "非阻塞建议",
-        "人工校验项",
-        "结论与建议",
-        "状态核对",
-        "证据原文",
-        "自我质疑",
-        "审查分歧账本回写"
-      ],
-      "required_patterns": [
-        "^### 审查决定$",
-        "^\\$ "
-      ]
+      "schema": "review-plan"
     },
     "decision-details": {},
     "review-summary": {

package/templates/.agents/skills/review-plan/reference/report-template.en.md

@@ -1,5 +1,7 @@
 # Review Report Template
 
+> Before writing this report, use `task-artifact init --family review-plan` to create the skeleton and preserve every `artifact-section` marker; the skeleton contains no review conclusion.
+
 Use this template when writing `review-plan.md` or `review-plan-r{N}.md`.
 
 ## Output Template
@@ -12,11 +14,31 @@ Use this template when writing `review-plan.md` or `review-plan-r{N}.md`.
 - **Review Input**:
   - `{plan-artifact}` (the highest-round technical-plan artifact actually reviewed, e.g. `plan-r2.md`; leave blank if it cannot be reliably determined)
 
-## State Check
+## Review Summary
 
-> Paste the raw state-check command output; each command starts with `$ `.
+## Qualification Audit Review
 
-## Review Summary
+> Use `.agents/rules/decision-qualification.md` to review the five tables: constraint dependencies, candidate qualification, classification results, upstream relations, and dependency snapshot.
+
+### Constraint Dependencies
+| constraint_id | constraint_digest | role | evidence |
+| --- | --- | --- | --- |
+
+### Candidate Qualification
+| candidate_id | status | impact | constraint_ids | evidence |
+| --- | --- | --- | --- | --- |
+
+### Classification Results
+| decision_id | classification | evidence |
+| --- | --- | --- |
+
+### Upstream Relations
+| upstream_family | upstream_artifact | upstream_round | upstream_sha256 | relation |
+| --- | --- | --- | --- | --- |
+
+### Dependency Snapshot
+| task_input_digest | non_constraint_input_digest | upstream_artifact_digest |
+| --- | --- | --- |
 
 - **Reviewer**: {reviewer-name}
 - **Review Time**: {timestamp}
@@ -24,7 +46,7 @@ Use this template when writing `review-plan.md` or `review-plan-r{N}.md`.
 - **Overall Verdict**: {Approved / Changes Requested / Rejected}
 - **Findings (AI-actionable)**: {unresolved-blockers} blockers, {unresolved-major} majors, {unresolved-minor} minors / **Manual validation**: 0
 
-## Review Coverage Declaration
+## Inspection Coverage
 
 | pass_id | scope | evidence | result | gaps_or_assumptions |
 |---------|-------|----------|--------|---------------------|
@@ -102,7 +124,7 @@ Use this template when writing `review-plan.md` or `review-plan-r{N}.md`.
 **File**: `{file-path}:{line-number}`
 **Suggestion**: {improvement suggestion}
 
-## Non-blocking Advisories
+## Non-blocking Suggestions
 
 > 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.
 
@@ -121,27 +143,42 @@ Use this template when writing `review-plan.md` or `review-plan-r{N}.md`.
 > If this round has no Manual validation items, keep the section heading and write "None".
 
 
-## Review Disagreement Ledger Writeback
+## Conclusion and Recommendation
 
-> Record the structured intents to submit: use `task-ledger finding-upsert` for new findings and `finding-review` for prior responses. The core allocates `PL-N` and validates transitions; do not edit task.md table rows.
-> 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.
+### Approval Decision
+- [ ] Approved
+- [ ] Changes Requested
+- [ ] Rejected
+
+### Next Steps
+{recommended next step}
+
+## State Check
 
-## Evidence
+> Record the state-check command, review scope, key result, and uncovered parts; each command starts with `$ `.
+> Follow `.agents/rules/evidence-reporting.md`: record review scope, key result, and uncovered parts; do not paste complete successful stdout.
 
-> 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.
+## Raw Evidence
+
+> 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.
 
 - Claim: {verified claim}
 ```text
 $ {command}
-{raw output}
+{result summary or decisive excerpt}
 ```
 
-## Self-Doubt
+## Self-critique
 
 > 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.
 
 - {an unverified conclusion or inference; note why it was not verified and the impact if it is overturned}
 
+## Review Disagreement Ledger Write-back
+
+> Record the structured intents to submit: use `task-ledger finding-upsert` for new findings and `finding-review` for prior responses. The core allocates `PL-N` and validates transitions; do not edit task.md table rows.
+> 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.
+
 ## Highlights
 
 - {what went well}
@@ -150,14 +187,4 @@ $ {command}
 
 - [ ] Implementation matches the technical plan
 - [ ] No unintended scope expansion
-
-## Conclusion and Recommendation
-
-### Approval Decision
-- [ ] Approved
-- [ ] Changes Requested
-- [ ] Rejected
-
-### Next Steps
-{recommended next step}
 ```

package/templates/.agents/skills/review-plan/reference/report-template.zh-CN.md

@@ -1,5 +1,7 @@
 # 审查报告模板
 
+> 写入本报告前，先用 `task-artifact init --family review-plan` 创建骨架，并保留每个 `artifact-section` marker；骨架不包含审查结论。
+
 编写 `review-plan.md` 或 `review-plan-r{N}.md` 时使用本模板。
 
 ## 输出模板
@@ -12,11 +14,31 @@
 - **审查输入**：
   - `{plan-artifact}`（本轮实际检视的最高轮技术方案产物，如 `plan-r2.md`；无法可靠取得则留空）
 
-## 状态核对
+## 审查摘要
 
-> 粘贴状态核对命令原文；每条命令以 `$ ` 开头。
+## 资格审计复核
 
-## 审查摘要
+> 按 `.agents/rules/decision-qualification.md` 复核：约束依赖、候选资格、分类结果、上游关系和依赖快照五张表。
+
+### 约束依赖
+| constraint_id | constraint_digest | role | evidence |
+| --- | --- | --- | --- |
+
+### 候选资格
+| candidate_id | status | impact | constraint_ids | evidence |
+| --- | --- | --- | --- | --- |
+
+### 分类结果
+| decision_id | classification | evidence |
+| --- | --- | --- |
+
+### 上游关系
+| upstream_family | upstream_artifact | upstream_round | upstream_sha256 | relation |
+| --- | --- | --- | --- | --- |
+
+### 依赖快照
+| task_input_digest | non_constraint_input_digest | upstream_artifact_digest |
+| --- | --- | --- |
 
 - **审查者**：{reviewer-name}
 - **审查时间**：{timestamp}
@@ -121,19 +143,29 @@
 > 如本轮无人工校验项，保留段落标题并写「（无）」。
 
 
-## 审查分歧账本回写
+## 结论与建议
 
-> 本段记录将提交的结构化意图：新 finding 用 `task-ledger finding-upsert`，上一轮响应复核用 `finding-review`；由核心分配 `PL-N` 并校验状态机，禁止手写 task.md 表格。
-> 凡升级为 `needs-human-decision` 的 finding，必须按 `.agents/rules/human-decision-context.md` 在本报告中提供自足详情块，并让 evidence 指向该稳定锚点。
+### 审查决定
+- [ ] 通过
+- [ ] 需要修改
+- [ ] 拒绝
+
+### 下一步
+{recommended next step}
+
+## 状态核对
+
+> 记录状态核对命令、审查范围、关键结果和未覆盖部分；每条命令以 `$ ` 开头。
+> 按 `.agents/rules/evidence-reporting.md` 同时记录审查范围、关键结果和未覆盖部分；正常成功不粘贴完整 stdout。
 
 ## 证据原文
 
-> 每条“我验证了 X”断言都要配对对应 tool output 原文；gate 仅校验本段存在和至少一行 `$ `。每条 Blocker 必须配可复现命令（rg/grep/sed/nl）及其原文；无法复现的判断须降级或移入「自我质疑」。
+> 遵循 `.agents/rules/evidence-reporting.md`：每条断言配对 `$ ` 命令和相称结果摘要；Blocker、失败、阻塞或争议必须保留可复现命令、准确位置和决定性摘录；无法复现的判断须降级或移入「自我质疑」。
 
 - 断言：{verified claim}
 ```text
 $ {command}
-{raw output}
+{result summary or decisive excerpt}
 ```
 
 ## 自我质疑
@@ -142,6 +174,11 @@ $ {command}
 
 - {未直接验证的结论或推断；说明为何未验证、若被推翻的影响}
 
+## 审查分歧账本回写
+
+> 本段记录将提交的结构化意图：新 finding 用 `task-ledger finding-upsert`，上一轮响应复核用 `finding-review`；由核心分配 `PL-N` 并校验状态机，禁止手写 task.md 表格。
+> 凡升级为 `needs-human-decision` 的 finding，必须按 `.agents/rules/human-decision-context.md` 在本报告中提供自足详情块，并让 evidence 指向该稳定锚点。
+
 ## 亮点
 
 - {what went well}
@@ -150,14 +187,4 @@ $ {command}
 
 - [ ] 实现与技术方案一致
 - [ ] 没有意外的范围扩张
-
-## 结论与建议
-
-### 审查决定
-- [ ] 通过
-- [ ] 需要修改
-- [ ] 拒绝
-
-### 下一步
-{recommended next step}
 ```

package/templates/.agents/skills/review-pr/SKILL.en.md

@@ -12,6 +12,10 @@ Based on the target PR's lifecycle-evidence completeness and change risk, select
 
 ## Boundary / Critical Rules
 
+### Persisted Report Evidence
+
+Before generating the PR review report, read `.agents/rules/evidence-reporting.md`. Normal review records the command, scope, structured result, actual conclusion, and uncovered parts; formal Review, findings, blocking conditions, or disputes retain exact identity fields and decisive evidence.
+
 - Strictly follow the fixed evidence-grading decision flow: host resolution → evidence classification → freshness/alignment → risk grading → mode selection
 - `pr-review*` is an independent artifact family: it does not join the analysis/plan/code stage chain and never changes `current_step`
 - Only a formal PR Review (head SHA, conclusion, findings, receipt, Issue artifact link) is published on the PR; no second full process copy goes to a regular PR comment
@@ -41,7 +45,7 @@ Before making any task-state judgment or user-visible conclusion, run the state
 agent-infra-internal task-snapshot {task-id} --format text
 ```
 
-The task-anchored path records the current task directory and existing `pr-review*` rounds before starting; the one-shot path (no task) records the PR number and target directory. Paste the state-check output into the `## State Check` section of this round's `pr-review-rN.md`.
+The task-anchored path records the current task directory and existing `pr-review*` rounds before starting; the one-shot path (no task) records the PR number and target directory. Record the command, PR/head, review 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, and retain decisive raw lines for identity mismatches, failures, blocking conditions, or disputes.
 
 ## Steps
 

package/templates/.agents/skills/review-pr/SKILL.zh-CN.md

@@ -12,6 +12,10 @@ description: >
 
 ## 行为边界 / 关键规则
 
+### 持久化报告证据
+
+生成 PR 审查报告时，先读取 `.agents/rules/evidence-reporting.md`。正常审查记录命令、范围、结构化结果、实际结论和未覆盖部分；正式 Review、finding、阻塞或争议的身份字段和决定性证据必须精确保留。
+
 - 严格遵循方案中固化的证据分级主决策流：宿主解析 → 证据分类 → 新鲜度/对齐 → 风险分级 → 模式选择
 - `pr-review*` 是独立 artifact family：不接入 analysis/plan/code 阶段依赖链，不修改 `current_step`
 - PR 上只发布正式 PR Review（head SHA、结论、finding、receipt、Issue artifact 链接），不发第二份完整过程原文到 PR 普通评论
@@ -41,7 +45,7 @@ description: >
 agent-infra-internal task-snapshot {task-id} --format text
 ```
 
-任务锚定路径在开始前记录当前任务目录与既有 `pr-review*` 轮次；一次性路径（无任务）记录 PR 编号与目标目录。状态核对输出粘贴到本轮产物 `pr-review-rN.md` 的 `## 状态核对` 段。
+任务锚定路径在开始前记录当前任务目录与既有 `pr-review*` 轮次；一次性路径（无任务）记录 PR 编号与目标目录。将命令、PR/head、审查范围、关键结果和未覆盖部分写入本轮产物 `pr-review-rN.md` 的 `## 状态核对` 段；正常成功不粘贴完整目录清单或 `task.md` 尾部，身份不一致、失败、阻塞或争议时保留决定性原文行。
 
 ## 执行步骤
 

package/templates/.agents/skills/review-pr/reference/report-template.en.md

@@ -11,7 +11,8 @@ Use the following structure when creating `pr-review.md` or `pr-review-r{N}.md`.
 
 ## State Check
 
-> Paste the state-check command output verbatim; each command starts with `$ `.
+> Record the state-check command, PR/head, review scope, key result, and uncovered parts; each command starts with `$ `.
+> Follow `.agents/rules/evidence-reporting.md`: record PR, head, review scope, key result, and uncovered parts; do not paste complete successful stdout.
 
 ## Identity
 
@@ -76,10 +77,10 @@ Land the following in order before the line-level findings, without impersonatin
 
 ## Evidence
 
-> Every "I verified X" assertion must pair with the corresponding tool output verbatim; the gate only checks this section exists and has at least one `$ ` line.
+> Follow `.agents/rules/evidence-reporting.md`: pair every assertion with a `$ ` command and proportionate result summary; formal Review, failures, blocking conditions, or disputes retain exact identity and decisive excerpts.
 
 - Assertion: {verified claim}
 ```text
 $ {command}
-{raw output}
+{result summary or decisive excerpt}
 ```

package/templates/.agents/skills/review-pr/reference/report-template.zh-CN.md

@@ -11,7 +11,8 @@
 
 ## 状态核对
 
-> 粘贴状态核对命令原文；每条命令以 `$ ` 开头。
+> 记录状态核对命令、PR/head、审查范围、关键结果和未覆盖部分；每条命令以 `$ ` 开头。
+> 按 `.agents/rules/evidence-reporting.md` 同时记录 PR、head、审查范围、关键结果和未覆盖部分；正常成功不粘贴完整 stdout。
 
 ## 身份信息
 
@@ -76,10 +77,10 @@
 
 ## 证据原文
 
-> 每条「我验证了 X」断言都要配对对应 tool output 原文；gate 仅校验本段存在和至少一行 `$ `。
+> 遵循 `.agents/rules/evidence-reporting.md`：每条断言配对 `$ ` 命令和相称结果摘要；正式 Review、失败、阻塞或争议保留准确身份和决定性摘录。
 
 - 断言：{verified claim}
 ```text
 $ {command}
-{raw output}
+{result summary or decisive excerpt}
 ```

package/templates/.agents/skills/run-manual-validation/SKILL.en.md

@@ -16,6 +16,10 @@ The entry point may omit the task ref; explicit task scope accepts only `--task
 
 ## Boundary
 
+### Persisted Report Evidence
+
+Before generating a validation report, read `.agents/rules/evidence-reporting.md`. Record only the command name, target scope, exit status, sanitized result, and coverage gap; never record complete argv, environment variables, tokens, absolute paths, or a raw sensitive transcript.
+
 - Select the validation mode, call the sole mechanical entry point, and record evidence; do not mark PR manual validation complete.
 - `complete-manual-validation` remains the maintainer's final registration after coverage is judged sufficient.
 - Never manipulate temporary worktrees, leases, or containers directly; only call `agent-infra-internal task-validate`.
@@ -24,7 +28,7 @@ The entry point may omit the task ref; explicit task scope accepts only `--task
 
 ## Step 0: State Check (pre-execution hard gate)
 
-Resolve the task reference, then run this command and copy its original output into the artifact:
+Resolve the task reference, then run this command and record the task/artifact scope, key result, and uncovered parts in the artifact; 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:
 
 ```bash
 agent-infra-internal task-snapshot {task-id} --format text

package/templates/.agents/skills/run-manual-validation/SKILL.zh-CN.md

@@ -16,6 +16,10 @@ description: >
 
 ## 行为边界
 
+### 持久化报告证据
+
+生成验证报告时，先读取 `.agents/rules/evidence-reporting.md`。只记录命令名称、目标范围、退出状态、sanitized result 和覆盖缺口；不得记录完整 argv、环境变量、token、绝对路径或原始敏感 transcript。
+
 - 本技能负责选择校验模式、调用唯一机械入口并记录证据；不把 PR 人工校验标为完成。
 - `complete-manual-validation` 仍是维护者确认覆盖充分后的最终登记入口。
 - 禁止直接操作临时 worktree、lease 或 container；只调用 `agent-infra-internal task-validate`。
@@ -24,7 +28,7 @@ description: >
 
 ## 第 0 步：状态核对（执行前硬约束）
 
-解析任务引用后运行，并把原文写入产物：
+解析任务引用后运行，并在产物中记录任务/产物范围、关键结果和未覆盖部分；正常成功不粘贴完整目录清单或 `task.md` 尾部，失败、阻塞、身份不一致或争议时附决定性原文行：
 
 ```bash
 agent-infra-internal task-snapshot {task-id} --format text

package/templates/.agents/skills/run-manual-validation/reference/report-template.en.md

@@ -10,8 +10,9 @@
 
 ```text
 $ agent-infra-internal task-snapshot {task-id} --format text
-{raw-output}
+{command-summary-and-key-result}
 ```
+> Follow `.agents/rules/evidence-reporting.md`: record command name, target scope, exit status, sanitized result, and coverage gap; do not paste complete argv or sensitive transcripts.
 
 ## Validation Target
 
@@ -67,3 +68,4 @@ $ agent-infra-internal task-snapshot {task-id} --format text
 $ agent-infra-internal task-validate {task-ref} --scope {scope} --format json -- {redacted-command}
 {sanitized-result}
 ```
+> Keep only the allowed public command and sanitized structured result; complete successful stdout is not default report content.

package/templates/.agents/skills/run-manual-validation/reference/report-template.zh-CN.md

@@ -10,8 +10,9 @@
 
 ```text
 $ agent-infra-internal task-snapshot {task-id} --format text
-{raw-output}
+{command-summary-and-key-result}
 ```
+> 按 `.agents/rules/evidence-reporting.md` 记录命令名称、目标范围、退出状态、sanitized result 和覆盖缺口；不得粘贴完整 argv 或敏感 transcript。
 
 ## 验证目标
 
@@ -67,3 +68,4 @@ $ agent-infra-internal task-snapshot {task-id} --format text
 $ agent-infra-internal task-validate {task-ref} --scope {scope} --format json -- {redacted-command}
 {sanitized-result}
 ```
+> 仅保留允许公开的命令与脱敏结构化结果；完整成功 stdout 不属于默认报告内容。

package/templates/.agents/skills/test/SKILL.en.md

@@ -27,6 +27,17 @@ Confirm no compilation errors.
 
 This project uses three test layers as an optional optimization; if the test suite is small, all layers may map to the same full test command.
 
+### fast smoke (target <5s)
+
+```bash
+# TODO: Replace with this project's fast smoke subset command
+# npm run test:smoke:fast       (Node.js)
+# pytest -m "not slow"          (Python)
+# go test -short ./...          (Go)
+```
+
+Use for code-task inner loops when the project provides a build-free fast path. It should cover the same tests as smoke while skipping redundant compilation or generation.
+
 ### smoke (target <5s)
 
 ```bash
@@ -37,8 +48,8 @@ This project uses three test layers as an optional optimization; if the test sui
 ```
 
 Use for:
-- code-task inner loops
-- save-and-run / frequent feedback
+- after completing an implementation step
+- save-and-run / frequent feedback when no fast path exists
 - project structure, configuration, and template contract checks
 
 ### core (target <15s)

package/templates/.agents/skills/test/SKILL.zh-CN.md

@@ -25,6 +25,17 @@ description: >
 
 三层测试是可选的反馈速度优化；如果测试套件较小，所有层级都可以映射到同一个完整测试命令。
 
+### fast smoke（目标 <5s）
+
+```bash
+# TODO：替换为项目的 fast smoke 子集命令
+# npm run test:smoke:fast       (Node.js)
+# pytest -m "not slow"          (Python)
+# go test -short ./...          (Go)
+```
+
+当项目提供不重复构建的快速路径时，用于 code-task 内循环。它应覆盖与 smoke 相同的测试，同时跳过重复的编译或生成步骤。
+
 ### smoke（目标 <5s）
 
 ```bash
@@ -35,8 +46,8 @@ description: >
 ```
 
 适用场景：
-- code-task 内循环
-- 保存即跑 / 频繁反馈
+- 完成一个实施步骤后
+- 项目没有 fast 路径时的保存即跑 / 频繁反馈
 - 仅断言项目结构、配置、模板契约
 
 ### core（目标 <15s）

package/templates/.agents/skills/update-agent-infra/scripts/sync-templates.js

@@ -1269,6 +1269,9 @@ function syncTemplates(projectRoot, templateRootOverride) {
     }
   }
   const version = resolveVersionFromTemplateRoot(templateRoot);
+  const projectTemplateRoot = path.join(projectRoot, 'templates');
+  const sourceRepositoryTemplate = fs.existsSync(projectTemplateRoot)
+    && fs.realpathSync(templateRoot) === fs.realpathSync(projectTemplateRoot);
 
   const { project, org, language: lang = 'en' } = cfg;
   const platformType = cfg.platform?.type || DEFAULTS.platform.type;
@@ -1771,6 +1774,17 @@ function syncTemplates(projectRoot, templateRootOverride) {
     for (const [tgt, src] of selected) {
       if (expectedTargets) expectedTargets.add(tgt);
 
+      if (sourceRepositoryTemplate && tgt === '.github/workflows/pr-label.yml') {
+        report.managed.protected.push({
+          target: tgt,
+          reason: 'source-repository',
+          baseline: trustedBaseline(managedBaselines[tgt]),
+          local: fs.existsSync(path.join(projectRoot, tgt)) ? sha256(fs.readFileSync(path.join(projectRoot, tgt))) : null,
+          template: sha256(renderContent(fs.readFileSync(path.join(templateRoot, src), 'utf8'), vars))
+        });
+        continue;
+      }
+
       if (matchesAny(tgt, merged) || matchesAny(tgt, ejected)) {
         report.managed.skippedMerged.push(tgt);
         continue;

package/templates/.agents/templates/task.en.md

@@ -36,10 +36,16 @@ delivery_remote_head:          # Most recent successfully delivered task branch
 
 ### Constraints
 
+| constraint_id | statement | status | authority | source | evidence | derived_from | approval_evidence |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+
 ### Confirmed Decisions
 
 ### Candidate and Rejected Options
 
+| candidate_id | statement | status | constraint_ids | impact | evidence |
+| --- | --- | --- | --- | --- | --- |
+
 ### Acceptance Criteria
 
 ### Open Questions

package/templates/.agents/templates/task.zh-CN.md

@@ -36,10 +36,16 @@ delivery_remote_head:          # 最近一次成功交付到 remote 的任务分
 
 ### 约束
 
+| constraint_id | statement | status | authority | source | evidence | derived_from | approval_evidence |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+
 ### 已确认决策
 
 ### 候选与否决方案
 
+| candidate_id | statement | status | constraint_ids | impact | evidence |
+| --- | --- | --- | --- | --- | --- |
+
 ### 验收标准
 
 ### 未决事项