@fitlab-ai/agent-infra 0.9.10 → 0.9.12

package/templates/.agents/skills/init-labels/SKILL.en.md

@@ -15,7 +15,7 @@ Initialize the repository's standard labels taxonomy.
 
 Confirm that:
 - read `.agents/rules/label-milestone-setup.md` first
-- use its authentication commands to verify platform access
+- the repository configuration and requested mapping are ready
 
 If any prerequisite fails, stop and report the matching error.
 
@@ -28,9 +28,9 @@ bash .agents/skills/init-labels/scripts/init-labels.sh
 ```
 
 The script and `.agents/rules/label-milestone-setup.md` are responsible for:
-- Capturing the current label snapshot before making changes
-- Creating or updating the standard label set with the platform-specific label command
-- Reporting unmatched platform-default labels such as `question` and `wontfix`
+- Reading the configured `labels.in` mapping and preserving unrelated labels
+- Selecting the provider leaf or returning a clear no-op/degraded result
+- Creating or updating the standard label set and reporting the final summary
 - Printing the final execution summary
 
 ### 3. Standard taxonomy
@@ -69,8 +69,8 @@ Show the current mapping and ask whether it should be updated.
 #### 4.3 Write the mapping and create labels
 
 1. Write the final mapping to `.agents/.airc.json` under `labels.in`.
-2. Create one `in: {key}` label for each mapping key by following the label-create command in `.agents/rules/label-milestone-setup.md`.
-3. After user confirmation, delete stale `in:` labels that are no longer present in the final mapping.
+2. Run `bash .agents/skills/init-labels/scripts/init-labels.sh` to create or update one `in: {key}` label for each mapping key.
+3. After user confirmation, rerun the script with `--cleanup-stale-in` to delete stale `in:` labels that are no longer present in the final mapping.
 
 ### 5. Output and behavior guarantees
 
@@ -82,7 +82,7 @@ The summary must include:
 - Any unmatched platform-default labels still present
 
 Operational notes:
-- The operation is idempotent because the rule-file command updates or overwrites existing labels in place.
+- The operation is idempotent because the provider leaf updates or overwrites existing labels in place.
 - `in:` labels are managed by the AI-guided step together with the `.airc.json` mapping.
 
 ### 6. Inform User
@@ -100,8 +100,7 @@ Next step - initialize milestones (optional):
 
 ## Error Handling
 
-- platform CLI not found: prompt "the platform CLI is not installed"
-- Authentication failed: prompt "the platform CLI is not authenticated"
-- Repository access failed: prompt "Unable to access the current repository with the platform CLI"
+- Provider capability unavailable: report the script's `degraded` or `no-op` result without claiming remote changes.
+- Provider authentication or repository access failure: report the script's non-zero exit status and diagnostic output; do not claim remote changes.
 - Permission error: prompt "No permission to manage labels in this repository"
 - API rate limit: prompt "platform API rate limit reached, please retry later"

package/templates/.agents/skills/init-labels/SKILL.zh-CN.md

@@ -15,7 +15,7 @@ description: >
 
 确认以下条件成立：
 - 执行前先读取 `.agents/rules/label-milestone-setup.md`
-- 按其中的认证命令验证平台访问能力
+- 仓库配置和请求的映射已准备完成
 
 如果任一条件失败，停止并输出对应错误。
 
@@ -28,9 +28,9 @@ bash .agents/skills/init-labels/scripts/init-labels.sh
 ```
 
 脚本与 `.agents/rules/label-milestone-setup.md` 共同负责：
-- 在修改前保存当前 label 快照
-- 使用平台对应的 label 创建或更新命令维护标准 label 集合
-- 提示仍然存在的平台预置 labels，例如 `question` 和 `wontfix`
+- 读取配置的 `labels.in` 映射并保留无关 label
+- 选择 provider 叶子，或返回明确的 no-op/degraded 结果
+- 创建或更新标准 label 集合并输出最终摘要
 - 输出最终执行摘要
 
 ### 3. 标准分类体系
@@ -69,8 +69,8 @@ bash .agents/skills/init-labels/scripts/init-labels.sh
 #### 4.3 写入配置并创建 label
 
 1. 将最终映射写入 `.agents/.airc.json` 的 `labels.in` 字段。
-2. 为每个映射 key 按 `.agents/rules/label-milestone-setup.md` 的 label 创建命令创建 `in: {key}` label。
-3. 询问用户确认后，清理不在最终映射中的旧 `in:` label。
+2. 执行 `bash .agents/skills/init-labels/scripts/init-labels.sh`，为每个映射 key 创建或更新 `in: {key}` label。
+3. 询问用户确认后，再使用 `--cleanup-stale-in` 重新执行脚本，清理不在最终映射中的旧 `in:` label。
 
 ### 5. 输出与行为保证
 
@@ -82,7 +82,7 @@ bash .agents/skills/init-labels/scripts/init-labels.sh
 - 仍然存在的未匹配平台预置 labels
 
 执行说明：
-- 整个操作具备幂等性，因为规则文件中的 label 创建命令按覆盖或更新方式执行。
+- 整个操作具备幂等性，因为 provider 叶子会按覆盖或更新方式处理已有 label。
 - `in:` labels 由 AI 引导步骤和 `.airc.json` 映射统一管理。
 
 ### 6. 告知用户
@@ -100,8 +100,7 @@ bash .agents/skills/init-labels/scripts/init-labels.sh
 
 ## 错误处理
 
-- 未找到平台 CLI：提示 "the platform CLI is not installed"
-- 认证失败：提示 "the platform CLI is not authenticated"
-- 仓库访问失败：提示 "Unable to access the current repository with the platform CLI"
+- provider 能力不可用：如实报告脚本的 `degraded` 或 `no-op` 结果，不得声称远端已变更。
+- provider 认证或仓库访问失败：如实报告脚本的非零退出状态和诊断输出；不得声称远端已变更。
 - 权限不足：提示 "No permission to manage labels in this repository"
 - API 限流：提示 "platform API rate limit reached, please retry later"

package/templates/.agents/skills/init-labels/scripts/init-labels.github.sh

@@ -2,6 +2,20 @@
 
 set -e
 
+cleanup_stale_in=false
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --cleanup-stale-in)
+      cleanup_stale_in=true
+      ;;
+    *)
+      echo "Unknown option: $1" >&2
+      exit 2
+      ;;
+  esac
+  shift
+done
+
 if ! command -v gh >/dev/null 2>&1; then
   echo "GitHub CLI (\`gh\`) is not installed"
   exit 1
@@ -53,11 +67,46 @@ help wanted	008672	Extra attention is needed
 dependencies	0366d6	Pull requests that update a dependency file
 EOF
 
+node - ".agents/.airc.json" > "$tmpdir/in.tsv" <<'NODE'
+const fs = require("node:fs");
+
+const configPath = process.argv[2];
+const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+const mapping = config.labels?.in;
+if (mapping === undefined) process.exit(0);
+if (!mapping || typeof mapping !== "object" || Array.isArray(mapping)) {
+  throw new Error("labels.in must be an object");
+}
+
+for (const key of Object.keys(mapping).sort()) {
+  if (!key || key.includes("\n") || key.includes("\r") || key.includes("\t")) {
+    throw new Error("labels.in keys must be non-empty single-line values");
+  }
+  process.stdout.write(`in: ${key}\tBFD4F2\tModule label for ${key}\n`);
+}
+NODE
+
+cut -f1 "$tmpdir/in.tsv" > "$tmpdir/in-names.txt"
+
+cat "$tmpdir/in.tsv" >> "$tmpdir/common.tsv"
+
 while IFS="$(printf '\t')" read -r name color description; do
   [ -n "$name" ] || continue
   gh label create "$name" --color "$color" --description "$description" --force
 done < "$tmpdir/common.tsv"
 
+if [ "$cleanup_stale_in" = true ]; then
+  while IFS= read -r name; do
+    case "$name" in
+      in:*)
+        if ! grep -Fqx "$name" "$tmpdir/in-names.txt"; then
+          gh label delete "$name" --yes
+        fi
+        ;;
+    esac
+  done < "$tmpdir/existing-names.txt"
+fi
+
 gh label list --limit 200 --json name --jq '.[].name' > "$tmpdir/final-names.txt"
 cp "$tmpdir/final-names.txt" "$tmpdir/final.txt"
 
@@ -69,11 +118,13 @@ for label in bug documentation duplicate enhancement invalid question wontfix; d
 done
 
 common_count="$(wc -l < "$tmpdir/common.tsv" | tr -d ' ')"
+dynamic_count="$(wc -l < "$tmpdir/in.tsv" | tr -d ' ')"
 
 echo "GitHub Labels initialized."
 echo
 echo "Summary:"
 echo "- Common labels created or updated: $common_count"
+echo "- in: labels created or updated: $dynamic_count"
 echo "- Exact-match GitHub defaults overwritten: good first issue, help wanted"
 
 if [ -s "$tmpdir/unmatched-defaults.txt" ]; then
@@ -87,4 +138,9 @@ echo
 echo "Notes:"
 echo "- theme: labels were intentionally not created."
 echo "- The operation is idempotent because every label uses gh label create --force."
-echo "- in: labels are managed by the AI-guided step in the SKILL."
+echo "- in: labels are derived from .agents/.airc.json labels.in."
+if [ "$cleanup_stale_in" = true ]; then
+  echo "- Stale in: labels were removed only for labels absent from the confirmed mapping."
+else
+  echo "- Stale in: labels were preserved; pass --cleanup-stale-in after mapping confirmation to remove them."
+fi

package/templates/.agents/skills/init-labels/scripts/init-labels.sh

@@ -2,5 +2,31 @@
 
 set -e
 
-echo "Label initialization skipped: this code platform does not provide a built-in label adapter." >&2
+cleanup_stale_in=false
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --cleanup-stale-in)
+      cleanup_stale_in=true
+      ;;
+    *)
+      echo "Unknown option: $1" >&2
+      exit 2
+      ;;
+  esac
+  shift
+done
+
+node - "$cleanup_stale_in" <<'NODE'
+const cleanupStaleIn = process.argv[2] === "true";
+process.stdout.write(`${JSON.stringify({
+  status: "degraded",
+  operation: "init-labels",
+  error: {
+    code: "PLATFORM_LABELS_UNSUPPORTED",
+    message: cleanupStaleIn
+      ? "The current platform does not provide a label adapter; stale labels were not removed."
+      : "The current platform does not provide a label adapter."
+  }
+})}\n`);
+NODE
 exit 0

package/templates/.agents/skills/init-milestones/SKILL.en.md

@@ -15,7 +15,7 @@ Initialize the repository's standard milestones taxonomy.
 
 Confirm that:
 - read `.agents/rules/label-milestone-setup.md` first
-- use its authentication commands to verify platform access
+- the requested milestone arguments are ready
 
 If any prerequisite fails, stop and report the matching error.
 
@@ -31,7 +31,7 @@ The script and `.agents/rules/label-milestone-setup.md` are responsible for:
 - Creating and cleaning up a temporary workspace
 - Detecting whether `--history` was requested
 - Scanning all `v*` Git tags, selecting the highest valid version by SemVer precedence, and using compatibility default `0.1.0` when none is valid, without reading ecosystem manifests
-- Listing current milestones with the platform-specific milestone query command
+- Letting the provider leaf list and write current milestones
 - Building the desired milestone set and creating only the missing titles
 - Printing the final execution summary
 
@@ -78,9 +78,7 @@ Next step - initialize labels (optional):
 
 ## Error Handling
 
-- platform CLI not found: prompt "the platform CLI is not installed"
-- Authentication failed: prompt "the platform CLI is not authenticated"
-- Repository access failed: prompt "Unable to access the current repository with the platform CLI"
+- Provider capability, authentication, or repository access failure: report the script's non-zero exit status and diagnostic output; do not claim remote changes.
 - Version detection failed: prompt "Unable to determine current version baseline"
 - No valid SemVer `v*` tags found in `--history` mode: prompt "No valid SemVer history tags found matching v*; only standard milestones will be created"
 - Permission error: prompt "No permission to manage milestones in this repository"

package/templates/.agents/skills/init-milestones/SKILL.zh-CN.md

@@ -15,7 +15,7 @@ description: >
 
 确认以下条件成立：
 - 执行前先读取 `.agents/rules/label-milestone-setup.md`
-- 按其中的认证命令验证平台访问能力
+- 请求的 milestone 参数已准备完成
 
 如果任一条件失败，停止并输出对应错误。
 
@@ -31,7 +31,7 @@ bash .agents/skills/init-milestones/scripts/init-milestones.sh "$ARGUMENTS"
 - 创建并清理临时工作目录
 - 检测是否传入 `--history`
 - 扫描所有 `v*` Git tag，按 SemVer precedence 选择最高合法版本；没有合法版本时使用兼容默认值 `0.1.0`，且不读取任何生态 manifest
-- 使用平台对应的 milestones 查询命令读取当前里程碑
+- 由 provider 叶子读取并写入当前里程碑
 - 构建目标里程碑集合，并且只创建缺失标题
 - 输出最终执行摘要
 
@@ -78,9 +78,7 @@ bash .agents/skills/init-milestones/scripts/init-milestones.sh "$ARGUMENTS"
 
 ## 错误处理
 
-- 未找到平台 CLI：提示 "the platform CLI is not installed"
-- 认证失败：提示 "the platform CLI is not authenticated"
-- 仓库访问失败：提示 "Unable to access the current repository with the platform CLI"
+- provider 能力、认证或仓库访问失败：如实报告脚本的非零退出状态和诊断输出；不得声称远端已变更。
 - 版本解析失败：提示 "Unable to determine current version baseline"
 - `--history` 模式下未找到合法 SemVer `v*` git tags：提示 "No valid SemVer history tags found matching v*; only standard milestones will be created"
 - 权限不足：提示 "No permission to manage milestones in this repository"

package/templates/.agents/skills/plan-task/SKILL.en.md

@@ -7,7 +7,7 @@ description: >
 ---
 
 # Design Technical Plan
-> `--agent` values follow the "Collaborator Token Specification" in `.agents/rules/task-management.md`: standard AI short tokens (`claude`/`codex`/`antigravity`/`opencode`/`cursor`), long-name normalization (`claude-code`->`claude`, `antigravity-cli`->`antigravity`), or the `human` manual exception.
+> `--agent` values are defined in `.agents/rules/task-management.md` under “Collaborator Token Specification”.
 
 If the entry operands contain `--orchestrated`, bind `{execution-flag}` to `--orchestrated` and forward it unchanged to the completed event; otherwise bind it to an empty value. Never infer it from `orchestration.json`, environment variables, or prior artifacts.
 
@@ -15,6 +15,7 @@ If the entry operands contain `--orchestrated`, bind `{execution-flag}` to `--or
 
 - This skill only outputs a technical plan document (`plan.md` or `plan-r{N}.md`) and does not modify any business code
 - This is a **mandatory human review checkpoint**; do not automatically proceed to implementation
+- 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
 - When the plan touches compatibility, migration, old formats, or old entry points, read `.agents/rules/compatibility-policy.md` first. Do not design adapters, shims, dual writes, or parallel state machines without passing its admission gate
 - After executing this skill, you **must** immediately update task status in task.md
 
@@ -24,7 +25,7 @@ Version stamp rule: when creating or updating `task.md` frontmatter, read `.agen
 
 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.
 
-Run these commands and paste the raw output into both the user-facing reply and this round's `## State Check` section:
+Run these commands and paste the raw output into this round's `## State Check` section:
 
 ```bash
 agent-infra-internal task-snapshot {task-id} --format text
@@ -34,7 +35,7 @@ Before the state check is complete, do not make external-state assertions such a
 
 ## Task Context Resolution
 
-> The entry point may omit the task ref and also accepts a legacy positional ref or `--task <ref>` / `-t <ref>`. Separate task scope from the full arguments while preserving every business operand, then call `agent-infra-internal task-context resolve {task-scope}` where `{task-scope}` is empty, one positional ref, or one task flag. Read only `taskId` from the structured result and bind `{task-id}` to that full `TASK-YYYYMMDD-HHMMSS` for downstream commands. Pass through resolution failures without scanning tasks locally.
+> The entry point may omit the task ref; explicit task scope accepts only `--task <ref>` or `-t <ref>`, and positional task refs are not interpreted. Preserve every other business operand, then call `agent-infra-internal task-context resolve {task-scope}` where `{task-scope}` is empty or one task flag. Read only `taskId` from the structured result and bind `{task-id}` to the full `TASK-YYYYMMDD-HHMMSS` for downstream commands. Pass through resolution failures without scanning tasks locally.
 
 > Resolve the task reference, then confirm that the task is in a state or directory supported by this skill and that `task.md` exists; if it cannot be located, handle it as a missing task and stop.
 

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

@@ -7,13 +7,14 @@ description: >
 ---
 
 # 设计技术方案
-> `--agent` 取值见 `.agents/rules/task-management.md`「合作者 token 规范」：标准 AI 短名（`claude`/`codex`/`antigravity`/`opencode`/`cursor`）、长名归一化（`claude-code`→`claude`、`antigravity-cli`→`antigravity`）或人工例外 `human`。
+> `--agent` 取值见 `.agents/rules/task-management.md`「合作者 token 规范」。
 
 若入口业务操作数包含 `--orchestrated`，绑定 `{execution-flag}` = `--orchestrated` 并原样转发给 completed 事件；否则绑定为空。不得从 `orchestration.json`、环境变量或历史产物推断该标记。
 
 ## 行为边界 / 关键规则
 
 - 本技能仅产出技术方案文档（`plan.md` 或 `plan-r{N}.md`）—— 不修改任何业务代码
+- 生成会同步到 Issue 的任务或生命周期 Markdown 前，先读取 `.agents/rules/sync-content-generation.md` 并遵循其中的生成端约束；同步端不解析或改写正文
 - 这是一个**强制性的人工审查检查点** —— 不要自动进入实现阶段
 - 方案涉及兼容、迁移、旧格式或旧入口时，先读取 `.agents/rules/compatibility-policy.md`；未通过准入门槛时不得设计 adapter、shim、双写或并行状态机
 - 执行本技能后，你**必须**立即更新 task.md 中的任务状态
@@ -24,7 +25,7 @@ description: >
 
 在加载 workflow / skill / rules 指令之后、做任何任务状态判断或用户可见结论之前，必须先执行状态核对。指令类文件读取不算对外动作或结论。
 
-运行以下命令，并把原文粘贴到回复正文和本轮产物的 `## 状态核对` 段：
+运行以下命令，并把原文粘贴到本轮产物的 `## 状态核对` 段：
 
 ```bash
 agent-infra-internal task-snapshot {task-id} --format text
@@ -34,7 +35,7 @@ agent-infra-internal task-snapshot {task-id} --format text
 
 ## 任务上下文解析
 
-> 入口允许省略 task ref，也接受旧位置 task ref 或 `--task <ref>` / `-t <ref>`。先从完整参数中分离 task scope 并原样保留其他业务操作数，再调用 `agent-infra-internal task-context resolve {task-scope}`；`{task-scope}` 为空、位置 ref 或 task flag 之一。只读取结构化结果的 `taskId`，后续把 `{task-id}` 绑定为该完整 `TASK-YYYYMMDD-HHMMSS`。解析失败时透传非零退出码，不自行扫描任务。
+> 入口可省略 task ref；显式 task scope 仅接受 `--task <ref>` 或 `-t <ref>`，不再解释位置 task ref。保留其余业务操作数后调用 `agent-infra-internal task-context resolve {task-scope}`；`{task-scope}` 为空或 task flag 之一。只读取结构化结果的 `taskId`，后续把 `{task-id}` 绑定为完整 `TASK-YYYYMMDD-HHMMSS`。解析失败时透传非零退出码，不自行扫描任务。
 
 > 解析任务引用，并确认任务位于本技能支持的状态或目录且存在 `task.md`；无法定位时按未找到任务处理并停止。
 

package/templates/.agents/skills/restore-task/SKILL.en.md

@@ -6,7 +6,7 @@ description: >
 ---
 
 # Restore Task
-> `--agent` values follow the "Collaborator Token Specification" in `.agents/rules/task-management.md`: standard AI short tokens (`claude`/`codex`/`antigravity`/`opencode`/`cursor`), long-name normalization (`claude-code`->`claude`, `antigravity-cli`->`antigravity`), or the `human` manual exception.
+> `--agent` values are defined in `.agents/rules/task-management.md` under “Collaborator Token Specification”.
 
 
 Restore local task workspace files from platform Issue comments that contain sync markers.

package/templates/.agents/skills/restore-task/SKILL.zh-CN.md

@@ -6,7 +6,7 @@ description: >
 ---
 
 # 还原任务
-> `--agent` 取值见 `.agents/rules/task-management.md`「合作者 token 规范」：标准 AI 短名（`claude`/`codex`/`antigravity`/`opencode`/`cursor`）、长名归一化（`claude-code`→`claude`、`antigravity-cli`→`antigravity`）或人工例外 `human`。
+> `--agent` 取值见 `.agents/rules/task-management.md`「合作者 token 规范」。
 
 
 从带有 sync 标记的平台 Issue 评论中恢复本地任务工作区文件。

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

@@ -7,7 +7,7 @@ description: >
 ---
 
 # Requirement Analysis Review
-> `--agent` values follow the "Collaborator Token Specification" in `.agents/rules/task-management.md`: standard AI short tokens (`claude`/`codex`/`antigravity`/`opencode`/`cursor`), long-name normalization (`claude-code`->`claude`, `antigravity-cli`->`antigravity`), or the `human` manual exception.
+> `--agent` values are defined in `.agents/rules/task-management.md` under “Collaborator Token Specification”.
 
 If the entry operands contain `--orchestrated`, bind `{execution-flag}` to `--orchestrated` and forward it unchanged to both the summary finalizer and completed event; otherwise bind it to an empty value. Never infer it from `orchestration.json`, environment variables, or prior artifacts.
 
@@ -16,6 +16,7 @@ Review the latest analysis artifact and produce `review-analysis.md` or `review-
 ## Boundary / Critical Rules
 
 - This skill only reviews analysis artifacts and writes a report; it does not modify product code.
+- 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
 - After executing this skill, you **must** immediately update task.md.
 
 Version stamp rule: when creating or updating `task.md` frontmatter, read `.agents/rules/version-stamp.md` first and write or refresh `agent_infra_version`.
@@ -24,7 +25,7 @@ Version stamp rule: when creating or updating `task.md` frontmatter, read `.agen
 
 After loading workflow / skill / rules instructions, and before any task-state judgment or user-visible conclusion, run the state check first.
 
-Run these commands and paste the raw output into both the user-facing reply and this round's `## State Check` section:
+Run these commands and paste the raw output into this round's `## State Check` section:
 
 ```bash
 agent-infra-internal task-snapshot {task-id} --format text
@@ -32,7 +33,7 @@ agent-infra-internal task-snapshot {task-id} --format text
 
 ## Task Context Resolution
 
-> The entry point may omit the task ref and also accepts a legacy positional ref or `--task <ref>` / `-t <ref>`. Separate task scope from the full arguments while preserving every business operand, then call `agent-infra-internal task-context resolve {task-scope}` where `{task-scope}` is empty, one positional ref, or one task flag. Read only `taskId` from the structured result and bind `{task-id}` to that full `TASK-YYYYMMDD-HHMMSS` for downstream commands. Pass through resolution failures without scanning tasks locally.
+> The entry point may omit the task ref; explicit task scope accepts only `--task <ref>` or `-t <ref>`, and positional task refs are not interpreted. Preserve every other business operand, then call `agent-infra-internal task-context resolve {task-scope}` where `{task-scope}` is empty or one task flag. Read only `taskId` from the structured result and bind `{task-id}` to the full `TASK-YYYYMMDD-HHMMSS` for downstream commands. Pass through resolution failures without scanning tasks locally.
 
 > Resolve the task reference, then confirm that the task is in a state or directory supported by this skill and that `task.md` exists; if it cannot be located, handle it as a missing task and stop.
 
@@ -69,7 +70,7 @@ Create `.agents/workspace/active/{task-id}/{review-artifact}`.
 
 ### 6. Update Task Status
 
-After the report, submit each new finding with `agent-infra-internal task-ledger {task-id} finding-upsert --stage analysis --review-artifact {review-artifact} --ordinal {n} --severity {blocker|major|minor} --evidence {review-artifact}#{anchor}`; submit prior-response dispositions with `finding-review --id {ledger-id} --status {confirmed|closed|open|needs-human-decision} --evidence {evidence}`. Do not scan ids or edit ledger rows. After all ledger writes, call `agent-infra-internal task-review {task-id} finalize-summary --stage analysis --artifact {review-artifact} {execution-flag}` exactly once.
+After the report, submit each new finding with `agent-infra-internal task-ledger {task-id} finding-upsert --stage analysis --review-artifact {review-artifact} --ordinal {n} --severity {blocker|major|minor} --evidence {review-artifact}#{anchor}`; submit prior-response dispositions with `finding-review --id {ledger-id} --status {confirmed|closed|open|needs-human-decision} --evidence {evidence}`. Do not scan ids or edit ledger rows. After all ledger writes, make the initial call to `agent-infra-internal task-review {task-id} finalize-summary --stage analysis --artifact {review-artifact} {execution-flag}`; after a failure, follow `.agents/rules/local-artifact-repair.md` to decide whether to edit and rerun, and never treat an error type or `changed=false` as automatic authorization.
 
 Bind and reuse this structured mapping from that one response:
 
@@ -79,12 +80,14 @@ Bind and reuse this structured mapping from that one response:
 {unresolved-minor} = stageStatus.unresolvedFindingCounts.minor
 ```
 
-The intent atomically finalizes the report summary and returns the same ledger snapshot. Do not call `stage-status`, replace placeholders manually, or rescan the finding list. If finalization fails or a response field is missing, stop before the completion event. Derive the verdict and next-step branch from the same response's `stageStatus.canAdvance`: only `canAdvance=true` permits `approved`; otherwise use `changes-requested` or `rejected`. Then run `agent-infra-internal task-event {task-id} review-analysis.completed --agent {standard-agent-token} --artifact {review-artifact} --verdict {approved|changes-requested|rejected} --blockers {unresolved-blockers} --major {unresolved-major} --minor {unresolved-minor} --manual-validation {n} {execution-flag}`.
+The intent atomically finalizes the report summary and returns the same ledger snapshot. Do not call `stage-status`, replace placeholders manually, or rescan the finding list. After a failure, the model may edit the same controlled artifact and rerun the same intent only when the shared rule's mechanical gates pass; reassess convergence after every failure. The final complete result determines the verdict and counts from that same snapshot: `stageStatus.canAdvance=true` with an Approved conclusion permits cross-stage advancement; `stageStatus.canAdvance=false` still requires `agent-infra-internal task-event {task-id} review-analysis.completed --agent {standard-agent-token} --artifact {review-artifact} --verdict {approved|changes-requested|rejected} --blockers {unresolved-blockers} --major {unresolved-major} --minor {unresolved-minor} --manual-validation {n} {execution-flag}`, using `changes-requested` and routing to same-stage revision/review (use `rejected` when the report explicitly rejects). On failure, model stop, lack of progress, or the emergency cap, do not publish a completion event or cross-stage command; use the `repair-stop` scenario in `reference/output-templates.md` to show existing summary/findings, the artifact, actual repair attempts, the last diagnostic, and the stop reason.
 
 `manual-validation` is the data source for the `Manual-validation` count folded into review rows in `ai task log`; do not add a parallel manual-verification field.
 
 If task.md has a valid `issue_number`, run `agent-infra-internal platform-comment sync {task-id} --kind task --agent {standard-agent-token}`, then `agent-infra-internal platform-comment sync {task-id} --kind artifact --artifact {review-artifact} --agent {standard-agent-token}`.
 
+Before writing the summary, the finalization intent checks decision-detail ids; any visible duplicate returns a structured failure and preserves the artifact bytes, while the model decides whether a minimal edit is safe under the shared rule. If the safety gates fail, diagnostics repeat, no byte-level progress occurs, or the emergency cap is reached, stop before the completion event; the stop path must still show the existing review result instead of hiding the artifact.
+
 ### 7. Run Completion Gate
 
 ```bash

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

@@ -7,7 +7,7 @@ description: >
 ---
 
 # 需求分析审查
-> `--agent` 取值见 `.agents/rules/task-management.md`「合作者 token 规范」：标准 AI 短名（`claude`/`codex`/`antigravity`/`opencode`/`cursor`）、长名归一化（`claude-code`→`claude`、`antigravity-cli`→`antigravity`）或人工例外 `human`。
+> `--agent` 取值见 `.agents/rules/task-management.md`「合作者 token 规范」。
 
 若入口业务操作数包含 `--orchestrated`，绑定 `{execution-flag}` = `--orchestrated` 并原样转发给 summary finalizer 与 completed 事件；否则绑定为空。不得从 `orchestration.json`、环境变量或历史产物推断该标记。
 
@@ -16,6 +16,7 @@ description: >
 ## 行为边界 / 关键规则
 
 - 本技能只审查分析产物并写报告，不修改业务代码
+- 生成会同步到 Issue 的任务或生命周期 Markdown 前，先读取 `.agents/rules/sync-content-generation.md` 并遵循其中的生成端约束；同步端不解析或改写正文
 - 执行本技能后，你**必须**立即更新 task.md
 
 版本戳规则：创建或更新 `task.md` frontmatter 时，先读取 `.agents/rules/version-stamp.md`，并写入或刷新 `agent_infra_version`。
@@ -24,7 +25,7 @@ description: >
 
 在加载 workflow / skill / rules 指令之后、做任何任务状态判断或用户可见结论之前，必须先执行状态核对。指令类文件读取不算对外动作或结论。
 
-运行以下命令，并把原文粘贴到回复正文和本轮产物的 `## 状态核对` 段：
+运行以下命令，并把原文粘贴到本轮产物的 `## 状态核对` 段：
 
 ```bash
 agent-infra-internal task-snapshot {task-id} --format text
@@ -34,7 +35,7 @@ agent-infra-internal task-snapshot {task-id} --format text
 
 ## 任务上下文解析
 
-> 入口允许省略 task ref，也接受旧位置 task ref 或 `--task <ref>` / `-t <ref>`。先从完整参数中分离 task scope 并原样保留其他业务操作数，再调用 `agent-infra-internal task-context resolve {task-scope}`；`{task-scope}` 为空、位置 ref 或 task flag 之一。只读取结构化结果的 `taskId`，后续把 `{task-id}` 绑定为该完整 `TASK-YYYYMMDD-HHMMSS`。解析失败时透传非零退出码，不自行扫描任务。
+> 入口可省略 task ref；显式 task scope 仅接受 `--task <ref>` 或 `-t <ref>`，不再解释位置 task ref。保留其余业务操作数后调用 `agent-infra-internal task-context resolve {task-scope}`；`{task-scope}` 为空或 task flag 之一。只读取结构化结果的 `taskId`，后续把 `{task-id}` 绑定为完整 `TASK-YYYYMMDD-HHMMSS`。解析失败时透传非零退出码，不自行扫描任务。
 
 > 解析任务引用，并确认任务位于本技能支持的状态或目录且存在 `task.md`；无法定位时按未找到任务处理并停止。
 
@@ -72,7 +73,7 @@ agent-infra-internal task-snapshot {task-id} --format text
 
 ### 6. 更新任务状态
 
-报告完成后，新 finding 逐条调用 `agent-infra-internal task-ledger {task-id} finding-upsert --stage analysis --review-artifact {review-artifact} --ordinal {n} --severity {blocker|major|minor} --evidence {review-artifact}#{anchor}`；复核上一轮响应时调用 `finding-review --id {ledger-id} --status {confirmed|closed|open|needs-human-decision} --evidence {相称证据}`。不得扫描编号或手写账本行。全部账本写入完成后只调用一次 `agent-infra-internal task-review {task-id} finalize-summary --stage analysis --artifact {review-artifact} {execution-flag}`。
+报告完成后，新 finding 逐条调用 `agent-infra-internal task-ledger {task-id} finding-upsert --stage analysis --review-artifact {review-artifact} --ordinal {n} --severity {blocker|major|minor} --evidence {review-artifact}#{anchor}`；复核上一轮响应时调用 `finding-review --id {ledger-id} --status {confirmed|closed|open|needs-human-decision} --evidence {相称证据}`。不得扫描编号或手写账本行。全部账本写入完成后首次调用 `agent-infra-internal task-review {task-id} finalize-summary --stage analysis --artifact {review-artifact} {execution-flag}`；失败后是否继续编辑并重跑，必须遵循 `.agents/rules/local-artifact-repair.md`，不能把失败类型或 `changed=false` 当作自动授权。
 
 从该次返回值绑定并复用以下结构化映射：
 
@@ -82,12 +83,14 @@ agent-infra-internal task-snapshot {task-id} --format text
 {unresolved-minor} = stageStatus.unresolvedFindingCounts.minor
 ```
 
-该 intent 原子最终化报告摘要并返回同一次账本快照；不得再调用 `stage-status`、手工替换占位符或扫描问题清单。最终化失败或返回字段缺失时，停止在完成事件之前。以同一次返回的 `stageStatus.canAdvance` 决定 verdict 和下一步：仅 `canAdvance=true` 可用 `approved`，否则必须用 `changes-requested` 或 `rejected`。随后执行 `agent-infra-internal task-event {task-id} review-analysis.completed --agent {standard-agent-token} --artifact {review-artifact} --verdict {approved|changes-requested|rejected} --blockers {unresolved-blockers} --major {unresolved-major} --minor {unresolved-minor} --manual-validation {n} {execution-flag}`。
+该 intent 原子最终化报告摘要并返回同一次账本快照；不得再调用 `stage-status`、手工替换占位符或扫描问题清单。失败后，模型只能在共享规则的机械安全门通过时修改同一个受控 artifact，并完整重跑相同 intent；每次失败都重新判断是否收敛。最终一次完整成功返回决定同一快照的 verdict 和计数：`stageStatus.canAdvance=true` 且结论为 Approved 时允许跨阶段推进；`stageStatus.canAdvance=false` 时仍须执行 `agent-infra-internal task-event {task-id} review-analysis.completed --agent {standard-agent-token} --artifact {review-artifact} --verdict {approved|changes-requested|rejected} --blockers {unresolved-blockers} --major {unresolved-major} --minor {unresolved-minor} --manual-validation {n} {execution-flag}`，使用 `changes-requested` 并路由到同阶段修订/复审（报告明确拒绝时使用 `rejected`）。失败、模型停止、无进展或紧急熔断时，不发布完成事件或跨阶段命令，但必须按 `reference/output-templates.md` 的 `repair-stop` 场景展示已有 summary/findings、artifact、实际修复次数、最后诊断和停止原因。
 
 `manual-validation` 是 `ai task log` 中 review 行「人工校验点」（EN `Manual-validation`）计数的数据源；不要新增并行人工验证字段。
 
 如果 task.md 中存在有效的 `issue_number`，调用 `agent-infra-internal platform-comment sync {task-id} --kind task --agent {standard-agent-token}`，再调用 `agent-infra-internal platform-comment sync {task-id} --kind artifact --artifact {review-artifact} --agent {standard-agent-token}`；失败按 `.agents/rules/issue-sync.md` 记录 warning。
 
+最终化 intent 会在写入摘要前检查详情块 ID；任何可见重复都返回结构化失败并保持 artifact 字节不变，由模型按共享规则判断是否进行最小编辑。无法通过安全门、诊断重复、没有实际字节变化或达到紧急熔断时，停止在完成事件之前；停止路径仍必须展示已有审查结果，不得吞掉 artifact 内容。
+
 ### 7. 完成校验
 
 ```bash

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

@@ -36,6 +36,7 @@
         "^\\$ "
       ]
     },
+    "decision-details": {},
     "review-summary": {
       "stage": "analysis"
     },

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

@@ -36,6 +36,7 @@
         "^\\$ "
       ]
     },
+    "decision-details": {},
     "review-summary": {
       "stage": "analysis"
     },

package/templates/.agents/skills/review-analysis/reference/output-templates.en.md

@@ -18,6 +18,24 @@ Rules:
 - The selected scenario must generate `{next-step-commands}` through the shared helper
 - The count line shows 4 numbers. `Human-decision` (`{h}`) counts this stage's `needs-human-decision` rows; because those rows are unresolved, `{h} > 0` means `canAdvance=false`. Expand the "Pending human-decision pre-block" from `.agents/rules/next-step-output.md` and show revision and re-review paths only.
 
+### Scenario R: Finalization stopped with results visible
+
+When the finalizer fails, or the model stops because of a safety gate, lack of progress, repeated diagnostics, or the emergency cap, use this scenario. Do not call the shared helper or output cross-stage commands.
+
+```text
+Task {task-id} review results were generated, but lifecycle advancement stopped.
+- Review artifact: .agents/workspace/active/{task-id}/{review-artifact}
+- Last valid summary/findings: {last-readable-review-result}
+- Local repair attempts: {repairAttempts}
+- Last diagnostic: {last-structured-diagnostic}
+- Stop reason: {stop-reason}
+- Completion event: not published | Cross-stage commands: not generated
+
+Note: only lifecycle advancement stopped; the existing review result remains available. Handle it manually or rerun the current review skill.
+```
+
+If the summary cannot be parsed safely, set `{last-readable-review-result}` to "summary could not be parsed safely" and retain the artifact path and raw structured diagnostic; do not infer counts or add a conclusion.
+
 ### Scenario A: Approved with no findings
 
 Populate `{next-step-commands}` for this scenario by running `agent-infra-internal agent-client next-steps --skill plan-task --task-ref {task-ref}`.

package/templates/.agents/skills/review-analysis/reference/output-templates.zh-CN.md

@@ -18,6 +18,24 @@
 - 所选场景必须通过统一 helper 生成 `{next-step-commands}`
 - 计数行固定显示 4 个数字。`人工裁决`（`{h}`）是本阶段 `needs-human-decision` 行数；它属于未闭环账本状态，因此 `{h} > 0` 时 `canAdvance=false`，必须按 `.agents/rules/next-step-output.md` 的「人工裁决待办前置块」展开详情，并只输出修订与复审路径。
 
+### 场景 R：最终化停止但结果可见
+
+当 finalizer 失败，或模型因安全门、无进展、重复诊断或紧急熔断停止时，使用本场景，不调用统一 helper，也不输出跨阶段命令。
+
+```text
+任务 {task-id} 审查结果已生成，但生命周期未推进。
+- 审查产物：.agents/workspace/active/{task-id}/{review-artifact}
+- 最后有效 summary/findings：{last-readable-review-result}
+- 本地修复次数：{repairAttempts}
+- 最后诊断：{last-structured-diagnostic}
+- 停止原因：{stop-reason}
+- 完成事件：未发布 | 跨阶段命令：未生成
+
+说明：本次仅停止生命周期推进，已有审查结果仍可查看。请先进行人工处理，或重新运行当前审查技能。
+```
+
+如果 summary 无法安全解析，`{last-readable-review-result}` 必须改为“摘要不可安全解析”，并保留 artifact 路径和原始结构化诊断；不得推算计数或补写结论。
+
 ### 场景 A：通过且无问题
 
 使用 `agent-infra-internal agent-client next-steps --skill plan-task --task-ref {task-ref}` 生成本场景的 `{next-step-commands}`。