@fitlab-ai/agent-infra 0.8.2 → 0.8.4

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

@@ -57,7 +57,7 @@ description: >
 获取当前时间：
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S%:z"
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 ```
 
 更新 `.agents/workspace/active/{task-id}/task.md`：
@@ -140,7 +140,7 @@ ai sandbox rm {branch}
 
 下一步 - 检查任务状态（解除阻塞后）：
   - Claude Code / OpenCode：/check-task {task-ref}
-  - Gemini CLI：/agent-infra:check-task {task-ref}
+  - Gemini CLI：/{{project}}:check-task {task-ref}
   - Codex CLI：$check-task {task-ref}
 ```
 

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

@@ -58,7 +58,7 @@ When syncing to the Issue, replace any existing `status:` labels with the inferr
 Get the current time:
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S%:z"
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 ```
 
 Update `task.md` in the task directory:

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

@@ -57,7 +57,7 @@ description: >
 获取当前时间：
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S%:z"
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 ```
 
 更新任务目录中的 `task.md`：
@@ -149,7 +149,7 @@ ai sandbox rm {branch}
 
 下一步 - 查看已转移任务：
   - Claude Code / OpenCode：/check-task {task-ref}
-  - Gemini CLI：/agent-infra:check-task {task-ref}
+  - Gemini CLI：/{{project}}:check-task {task-ref}
   - Codex CLI：$check-task {task-ref}
 ```
 

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

@@ -78,15 +78,15 @@ ai task status {task-id}
 
 | 当前状态           | Claude Code / OpenCode       | Gemini CLI                               | Codex CLI                    |
 |--------------------|------------------------------|------------------------------------------|------------------------------|
-| 分析完成           | `/review-analysis {task-ref}` | `/agent-infra:review-analysis {task-ref}` | `$review-analysis {task-ref}` |
-| 需求分析审查通过   | `/plan-task {task-ref}`       | `/agent-infra:plan-task {task-ref}`       | `$plan-task {task-ref}`       |
-| 需求分析审查有问题 | `/analyze-task {task-ref}`    | `/agent-infra:analyze-task {task-ref}`    | `$analyze-task {task-ref}`    |
-| 计划完成           | `/review-plan {task-ref}`     | `/agent-infra:review-plan {task-ref}`     | `$review-plan {task-ref}`     |
-| 技术方案审查通过   | `/code-task {task-ref}`       | `/agent-infra:code-task {task-ref}`       | `$code-task {task-ref}`       |
-| 技术方案审查有问题 | `/plan-task {task-ref}`       | `/agent-infra:plan-task {task-ref}`       | `$plan-task {task-ref}`       |
-| 实现完成           | `/review-code {task-ref}`     | `/agent-infra:review-code {task-ref}`     | `$review-code {task-ref}`     |
-| 代码审查通过       | `/commit`                    | `/agent-infra:commit`                    | `$commit`                    |
-| 代码审查有问题     | `/code-task {task-ref}`       | `/agent-infra:code-task {task-ref}`       | `$code-task {task-ref}`       |
+| 分析完成           | `/review-analysis {task-ref}` | `/{{project}}:review-analysis {task-ref}` | `$review-analysis {task-ref}` |
+| 需求分析审查通过   | `/plan-task {task-ref}`       | `/{{project}}:plan-task {task-ref}`       | `$plan-task {task-ref}`       |
+| 需求分析审查有问题 | `/analyze-task {task-ref}`    | `/{{project}}:analyze-task {task-ref}`    | `$analyze-task {task-ref}`    |
+| 计划完成           | `/review-plan {task-ref}`     | `/{{project}}:review-plan {task-ref}`     | `$review-plan {task-ref}`     |
+| 技术方案审查通过   | `/code-task {task-ref}`       | `/{{project}}:code-task {task-ref}`       | `$code-task {task-ref}`       |
+| 技术方案审查有问题 | `/plan-task {task-ref}`       | `/{{project}}:plan-task {task-ref}`       | `$plan-task {task-ref}`       |
+| 实现完成           | `/review-code {task-ref}`     | `/{{project}}:review-code {task-ref}`     | `$review-code {task-ref}`     |
+| 代码审查通过       | `/commit`                    | `/{{project}}:commit`                    | `$commit`                    |
+| 代码审查有问题     | `/code-task {task-ref}`       | `/{{project}}:code-task {task-ref}`       | `$code-task {task-ref}`       |
 | 任务被阻塞         | 解除阻塞或提供所需信息       | —                                        | 解除阻塞或提供所需信息       |
 | 任务已完成         | 无需操作                     | —                                        | 无需操作                     |
 

package/templates/.agents/skills/close-codescan/SKILL.en.md

@@ -88,7 +88,7 @@ If a related task exists (search for `codescan_alert_number: <alert-number>`):
 Get the current time:
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S%:z"
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 ```
 
 - Add the dismissal record to task.md

package/templates/.agents/skills/close-codescan/SKILL.zh-CN.md

@@ -88,7 +88,7 @@ Code Scanning 告警 #{alert-number}
 获取当前时间：
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S%:z"
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 ```
 
 - 添加关闭记录到 task.md
@@ -128,7 +128,7 @@ ai sandbox rm {branch}
 
 下一步 - 完成并归档任务（如有关联任务）：
   - Claude Code / OpenCode：/complete-task {task-ref}
-  - Gemini CLI：/agent-infra:complete-task {task-ref}
+  - Gemini CLI：/{{project}}:complete-task {task-ref}
   - Codex CLI：$complete-task {task-ref}
 ```
 

package/templates/.agents/skills/close-dependabot/SKILL.en.md

@@ -96,7 +96,7 @@ If a related task exists (search for `security_alert_number: <alert-number>`):
 Get the current time:
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S%:z"
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 ```
 
 - Add the dismissal record to task.md

package/templates/.agents/skills/close-dependabot/SKILL.zh-CN.md

@@ -96,7 +96,7 @@ CVE：{cve-id}
 获取当前时间：
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S%:z"
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 ```
 
 - 添加关闭记录到 task.md
@@ -136,7 +136,7 @@ ai sandbox rm {branch}
 
 下一步 - 完成并归档任务（如有关联任务）：
   - Claude Code / OpenCode：/complete-task {task-ref}
-  - Gemini CLI：/agent-infra:complete-task {task-ref}
+  - Gemini CLI：/{{project}}:complete-task {task-ref}
   - Codex CLI：$complete-task {task-ref}
 ```
 

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

@@ -114,7 +114,7 @@ Create `.agents/workspace/active/{task-id}/{code-artifact}`.
 Get the current time:
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S%:z"
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 ```
 
 Set `current_step` to `code`, refresh task metadata, and append one Activity Log entry:

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

@@ -156,7 +156,7 @@ echo "$result"
 获取当前时间：
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S%:z"
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 ```
 
 更新 `.agents/workspace/active/{task-id}/task.md`：

package/templates/.agents/skills/code-task/reference/branch-management.zh-CN.md

@@ -4,7 +4,7 @@
 
 ## 分支名规则
 
-- 格式：`agent-infra-{type}-{slug}`
+- 格式：`{{project}}-{type}-{slug}`
 - 项目前缀：读取 `.agents/.airc.json` 中的 `project`
 - `{type}`：读取 `task.md` frontmatter 中的 `type`
 - `{slug}`：根据任务标题提取 3-6 个英文关键词，转为 kebab-case
@@ -23,7 +23,7 @@
 - 当前分支不一致：按下方”创建与切换命令”章节切换到已记录分支
 
 场景 B：`task.md` 未记录任务分支
-- 判断当前分支是否符合项目分支命名规范（`agent-infra-{type}-{slug}`）且语义上属于当前任务
+- 判断当前分支是否符合项目分支命名规范（`{{project}}-{type}-{slug}`）且语义上属于当前任务
 - 符合：将当前分支名回写到 `task.md`，继续
 - 不符合：生成新的任务分支名，按下方”创建与切换命令”章节创建并切换，回写到 `task.md`
 

package/templates/.agents/skills/code-task/reference/fix-mode.en.md

@@ -74,11 +74,11 @@ Fix status:
 Next step - re-review or commit:
 - Re-review (always recommended):
   - Claude Code / OpenCode: /review-code {task-ref}
-  - Gemini CLI: /agent-infra:review-code {task-ref}
+  - Gemini CLI: /{{project}}:review-code {task-ref}
   - Codex CLI: $review-code {task-ref}
 - Commit directly (optional; only when all issues are resolved and changes are low risk):
   - Claude Code / OpenCode: /commit
-  - Gemini CLI: /agent-infra:commit
+  - Gemini CLI: /{{project}}:commit
   - Codex CLI: $commit
 ```
 

package/templates/.agents/skills/code-task/reference/fix-mode.zh-CN.md

@@ -74,11 +74,11 @@ manual-validation 项不在修复范围。处理规则：
 下一步 - 重新审查或提交：
 - 重新审查（始终推荐）：
   - Claude Code / OpenCode：/review-code {task-ref}
-  - Gemini CLI：/agent-infra:review-code {task-ref}
+  - Gemini CLI：/{{project}}:review-code {task-ref}
   - Codex CLI：$review-code {task-ref}
 - 直接提交（可选；仅在所有问题已解决且风险可控时）：
   - Claude Code / OpenCode：/commit
-  - Gemini CLI：/agent-infra:commit
+  - Gemini CLI：/{{project}}:commit
   - Codex CLI：$commit
 ```
 

package/templates/.agents/skills/code-task/reference/output-template.zh-CN.md

@@ -15,6 +15,6 @@
 
 下一步 - 代码审查：
   - Claude Code / OpenCode：/review-code {task-ref}
-  - Gemini CLI：/agent-infra:review-code {task-ref}
+  - Gemini CLI：/{{project}}:review-code {task-ref}
   - Codex CLI：$review-code {task-ref}
 ```

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

@@ -91,7 +91,7 @@ Fold the push outcome (pushed / skipped(no PR) / failed) into the next step's "U
 Get the current time:
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S%:z"
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 ```
 
 > The full four-case status matrix, prerequisite checks, and multi-TUI next-step commands live in `reference/task-status-update.md`. Read `reference/task-status-update.md` before updating task state.

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

@@ -91,7 +91,7 @@ c. 安全降级（不阻塞已完成的 `git commit`，仅提示用户）：
 获取当前时间：
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S%:z"
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 ```
 
 > 完整的 4 种状态分支、前置条件检查和多 TUI 下一步命令见 `reference/task-status-update.md`。更新任务状态前，先读取 `reference/task-status-update.md`。

package/templates/.agents/skills/commit/reference/task-status-update.en.md

@@ -9,7 +9,7 @@ Before updating task metadata, read `.agents/rules/version-stamp.md` and refresh
 Get the current time first:
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S%:z"
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 ```
 
 For every task-related commit, append this Activity Log entry in `task.md`:
@@ -60,7 +60,7 @@ Required next-step commands (rendered by `prFlow`):
 ```text
 Next step - complete and archive the task:
   - Claude Code / OpenCode: /complete-task {task-ref}
-  - Gemini CLI: /agent-infra:complete-task {task-ref}
+  - Gemini CLI: /{{project}}:complete-task {task-ref}
   - Codex CLI: $complete-task {task-ref}
 ```
 
@@ -69,7 +69,7 @@ Next step - complete and archive the task:
 ```text
 Next step - create Pull Request:
   - Claude Code / OpenCode: /create-pr {task-ref}
-  - Gemini CLI: /agent-infra:create-pr {task-ref}
+  - Gemini CLI: /{{project}}:create-pr {task-ref}
   - Codex CLI: $create-pr {task-ref}
 ```
 
@@ -79,11 +79,11 @@ field absent -> two options:
 Next step - choose one:
   - Go through the PR flow:
     - Claude Code / OpenCode: /create-pr {task-ref}
-    - Gemini CLI: /agent-infra:create-pr {task-ref}
+    - Gemini CLI: /{{project}}:create-pr {task-ref}
     - Codex CLI: $create-pr {task-ref}
   - Complete directly (no PR):
     - Claude Code / OpenCode: /complete-task {task-ref}
-    - Gemini CLI: /agent-infra:complete-task {task-ref}
+    - Gemini CLI: /{{project}}:complete-task {task-ref}
     - Codex CLI: $complete-task {task-ref}
 ```
 
@@ -108,7 +108,7 @@ Required next-step commands:
 ```text
 Next step - code review:
   - Claude Code / OpenCode: /review-code {task-ref}
-  - Gemini CLI: /agent-infra:review-code {task-ref}
+  - Gemini CLI: /{{project}}:review-code {task-ref}
   - Codex CLI: $review-code {task-ref}
 ```
 

package/templates/.agents/skills/commit/reference/task-status-update.zh-CN.md

@@ -9,7 +9,7 @@
 先获取当前时间：
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S%:z"
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
 ```
 
 对于每一次与任务相关的提交，都要在 `task.md` 中追加以下 Activity Log：
@@ -60,7 +60,7 @@ last_reviewed_commit: {new_head}
 ```text
 下一步 - 完成并归档任务：
   - Claude Code / OpenCode: /complete-task {task-ref}
-  - Gemini CLI: /agent-infra:complete-task {task-ref}
+  - Gemini CLI: /{{project}}:complete-task {task-ref}
   - Codex CLI: $complete-task {task-ref}
 ```
 
@@ -69,7 +69,7 @@ last_reviewed_commit: {new_head}
 ```text
 下一步 - 创建 Pull Request：
   - Claude Code / OpenCode: /create-pr {task-ref}
-  - Gemini CLI: /agent-infra:create-pr {task-ref}
+  - Gemini CLI: /{{project}}:create-pr {task-ref}
   - Codex CLI: $create-pr {task-ref}
 ```
 
@@ -79,11 +79,11 @@ last_reviewed_commit: {new_head}
 下一步 - 二选一：
   - 走 PR 流程：
     - Claude Code / OpenCode: /create-pr {task-ref}
-    - Gemini CLI: /agent-infra:create-pr {task-ref}
+    - Gemini CLI: /{{project}}:create-pr {task-ref}
     - Codex CLI: $create-pr {task-ref}
   - 直接完成（无 PR）：
     - Claude Code / OpenCode: /complete-task {task-ref}
-    - Gemini CLI: /agent-infra:complete-task {task-ref}
+    - Gemini CLI: /{{project}}:complete-task {task-ref}
     - Codex CLI: $complete-task {task-ref}
 ```
 
@@ -108,7 +108,7 @@ last_reviewed_commit: {new_head}
 ```text
 下一步 - 代码审查：
   - Claude Code / OpenCode: /review-code {task-ref}
-  - Gemini CLI: /agent-infra:review-code {task-ref}
+  - Gemini CLI: /{{project}}:review-code {task-ref}
   - Codex CLI: $review-code {task-ref}
 ```
 

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

@@ -0,0 +1,142 @@
+---
+name: complete-manual-validation
+description: >
+  Mark PR manual validation as completed and update the manual-validation section
+  in the existing PR summary comment in place.
+---
+
+# Complete Manual Validation
+
+## Boundary / Critical Rules
+
+- This skill closes the manual-validation status in an existing PR summary comment; it does not create a parallel ordinary validation comment.
+- It must write `manual-validation.md` or `manual-validation-r{N}.md` so later PR summary refreshes can reuse the validation result.
+- If the `sync-pr` summary comment is missing, fail instead of creating a partial fallback summary.
+- After this skill runs, update `task.md` immediately.
+
+Version stamp rule: when creating or updating `task.md` frontmatter, read `.agents/rules/version-stamp.md` first and write or refresh `agent_infra_version`.
+
+## Step 0: State Check (pre-execution hard gate)
+
+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:
+
+```bash
+git status -s
+ls -la .agents/workspace/active/{task-id}/
+tail .agents/workspace/active/{task-id}/task.md
+```
+
+## Task id short ref
+
+> If `{task-id}` matches `^[#]?[0-9]+$` (bare numeric or `#`-prefixed), follow the "SKILL parameter resolver" section of `.agents/rules/task-short-id.md`; treat `{task-id}` as the resolved full `TASK-YYYYMMDD-HHMMSS` form for every downstream command.
+
+## Step Start: Write the started Marker
+
+After confirming prerequisites and the artifact round, and before this round's first artifact action, append a started marker to task.md `## Activity Log`:
+
+```
+- {YYYY-MM-DD HH:mm:ss±HH:MM} — **Complete Manual Validation [started]** by {agent} — started
+```
+
+See the "Activity Log started / done dual-marker convention" in `.agents/rules/task-management.md`.
+
+## Steps
+
+### 1. Parse Arguments
+
+Input:
+
+```text
+complete-manual-validation {task-ref} [{pr-ref}] {verification-summary}
+```
+
+- `{task-ref}` is required.
+- `{pr-ref}` is optional and accepts `#NN`, `NN`, or a full PR URL.
+- `{verification-summary}` is required. If it is missing, stop and ask for a validation summary; do not write an artifact or update the PR.
+
+### 2. Verify Prerequisites
+
+Check:
+- `.agents/workspace/active/{task-id}/task.md`
+- a valid PR: prefer explicit `{pr-ref}`, otherwise read `pr_number` from task.md frontmatter
+
+Stop if the task is missing, the validation summary is missing, or no valid PR can be resolved.
+
+### 3. Determine Artifact Round
+
+Scan the task directory:
+- no `manual-validation.md` and no `manual-validation-r*.md` -> write `manual-validation.md`
+- `manual-validation.md` exists and no `manual-validation-r*.md` -> write `manual-validation-r2.md`
+- `manual-validation-r{N}.md` exists -> write `manual-validation-r{N+1}.md`
+
+### 4. Update the PR Summary
+
+Before this step, read:
+- `.agents/rules/issue-sync.md`
+- `.agents/rules/pr-sync.md`
+- `reference/summary-update.md`
+
+Follow `reference/summary-update.md` to resolve the PR number, find the `sync-pr` summary comment, extract the manual-validation scope, and update the section to `### ✅ Manual Validation Passed`.
+
+### 5. Create the Manual Validation Artifact
+
+Before this step, read `reference/report-template.md`. Create `{manual-validation-artifact}` and record:
+- State check
+- Validation verdict
+- Validation scope
+- Validation details
+- PR summary sync result
+
+### 6. Update task.md
+
+Get the current time:
+
+```bash
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
+```
+
+Update `.agents/workspace/active/{task-id}/task.md`:
+- `updated_at`: current time
+- `assigned_to`: current agent
+- `agent_infra_version`: value from `.agents/rules/version-stamp.md`
+- keep `current_step` unchanged
+- append the `{manual-validation-artifact}` link and PR summary sync result to `## Implementation Notes`
+- append Activity Log:
+  ```
+  - {YYYY-MM-DD HH:mm:ss±HH:MM} — **Complete Manual Validation** by {agent} — Manual validation passed → {manual-validation-artifact}; {summary-result}
+  ```
+
+If the task has a valid `issue_number`, follow `.agents/rules/issue-sync.md` to update the task comment and publish the `{manual-validation-artifact}` comment.
+
+### 7. Verification Gate
+
+Run:
+
+```bash
+node .agents/scripts/validate-artifact.js gate complete-manual-validation .agents/workspace/active/{task-id} {manual-validation-artifact} --format text
+```
+
+Handle the result:
+- Exit code 0 -> tell the user
+- Exit code 1 -> fix the reported problem and rerun
+- Exit code 2 -> stop and report that manual intervention is required
+
+### 8. Tell the User
+
+Report:
+- Artifact path
+- PR summary sync result
+- Current verification output
+- Suggested next step: continue with `commit` / `create-pr`, or enter the final review flow
+
+Before rendering the final output, read `.agents/rules/next-step-output.md` and append `Completed at: YYYY-MM-DD HH:mm:ss` as the absolute last line.
+
+## Completion Checklist
+
+- [ ] Read `reference/summary-update.md`
+- [ ] Created the manual validation artifact
+- [ ] Updated the same PR summary comment, or stopped according to failure semantics
+- [ ] Updated task.md and appended the Activity Log
+- [ ] Ran the verification gate

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

@@ -0,0 +1,142 @@
+---
+name: complete-manual-validation
+description: >
+  标记 PR 人工验证已完成，并原地更新 PR 摘要评论中的人工校验段落。
+  当维护者已完成真实环境或权限相关人工验证、需要统一收尾 PR 摘要时使用。
+---
+
+# 完成人工验证
+
+## 行为边界 / 关键规则
+
+- 本技能用于收尾已有 PR 摘要评论中的人工校验状态，不创建并行的普通验证留言。
+- 必须写入 `manual-validation.md` 或 `manual-validation-r{N}.md`，让后续 PR 摘要刷新可复用人工验证结果。
+- 找不到 `sync-pr` 摘要评论时失败，不创建部分摘要兜底。
+- 执行本技能后必须立即更新 `task.md`。
+
+版本戳规则：创建或更新 `task.md` frontmatter 时，先读取 `.agents/rules/version-stamp.md`，并写入或刷新 `agent_infra_version`。
+
+## 第 0 步：状态核对（执行前硬约束）
+
+在加载 workflow / skill / rules 指令之后、做任何任务状态判断或用户可见结论之前，必须先执行状态核对。指令类文件读取不算对外动作或结论。
+
+运行以下命令，并把原文粘贴到回复正文和本轮产物的 `## 状态核对` 段：
+
+```bash
+git status -s
+ls -la .agents/workspace/active/{task-id}/
+tail .agents/workspace/active/{task-id}/task.md
+```
+
+## 任务入参短号别名
+
+> 如果 `{task-id}` 入参匹配 `^[#]?[0-9]+$`（裸数字或带 `#` 前缀），先读取 `.agents/rules/task-short-id.md` 的「SKILL 入参解析」段执行解析；后续命令视 `{task-id}` 为解析后的全长 `TASK-YYYYMMDD-HHMMSS` 形式。
+
+## 步骤开始：写入 started 标记
+
+确认前置条件和产物轮次后、本轮第一个产出动作之前，向 task.md `## 活动日志` 追加一条 started 标记：
+
+```
+- {YYYY-MM-DD HH:mm:ss±HH:MM} — **Complete Manual Validation [started]** by {agent} — started
+```
+
+格式与配对规则见 `.agents/rules/task-management.md` 的「Activity Log started / done 双标记约定」。
+
+## 执行步骤
+
+### 1. 解析入参
+
+输入格式：
+
+```text
+complete-manual-validation {task-ref} [{pr-ref}] {verification-summary}
+```
+
+- `{task-ref}` 必填。
+- `{pr-ref}` 可选，支持 `#NN`、`NN` 或完整 PR URL。
+- `{verification-summary}` 必填。若缺失，立即停止并提示补充验证说明；不写产物、不更新 PR。
+
+### 2. 验证前置条件
+
+检查：
+- `.agents/workspace/active/{task-id}/task.md`
+- 有效 PR：优先使用显式 `{pr-ref}`，否则读取 task.md frontmatter 的 `pr_number`
+
+如果任务不存在、验证说明缺失，或无法解析有效 PR，立即停止。
+
+### 3. 确定产物轮次
+
+扫描任务目录：
+- 不存在 `manual-validation.md` 且不存在 `manual-validation-r*.md` -> 本轮产物为 `manual-validation.md`
+- 已存在 `manual-validation.md` 且不存在 `manual-validation-r*.md` -> 本轮产物为 `manual-validation-r2.md`
+- 已存在 `manual-validation-r{N}.md` -> 本轮产物为 `manual-validation-r{N+1}.md`
+
+### 4. 更新 PR 摘要
+
+执行此步骤前，先读取：
+- `.agents/rules/issue-sync.md`
+- `.agents/rules/pr-sync.md`
+- `reference/summary-update.md`
+
+按 `reference/summary-update.md` 解析 PR 号、查找 `sync-pr` 摘要评论、提取待人工校验范围，并把人工校验段落更新为 `### ✅ 人工验证已通过`。
+
+### 5. 创建人工验证产物
+
+执行此步骤前，先读取 `reference/report-template.md`。创建 `{manual-validation-artifact}`，记录：
+- 状态核对
+- 验证结论
+- 验证范围
+- 验证详情
+- PR 摘要同步结果
+
+### 6. 更新 task.md
+
+获取当前时间：
+
+```bash
+date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'
+```
+
+更新 `.agents/workspace/active/{task-id}/task.md`：
+- `updated_at`：{当前时间}
+- `assigned_to`：{当前代理}
+- `agent_infra_version`：按 `.agents/rules/version-stamp.md` 取值
+- 保持 `current_step` 不变
+- 在 `## 实现备注` 中追加 `{manual-validation-artifact}` 链接和 PR 摘要同步结果
+- 追加 Activity Log：
+  ```
+  - {YYYY-MM-DD HH:mm:ss±HH:MM} — **Complete Manual Validation** by {agent} — Manual validation passed → {manual-validation-artifact}; {summary-result}
+  ```
+
+如任务存在有效 `issue_number`，按 `.agents/rules/issue-sync.md` 更新 task 评论并发布 `{manual-validation-artifact}` 评论。
+
+### 7. 完成校验
+
+运行完成校验：
+
+```bash
+node .agents/scripts/validate-artifact.js gate complete-manual-validation .agents/workspace/active/{task-id} {manual-validation-artifact} --format text
+```
+
+处理结果：
+- 退出码 0 -> 告知用户
+- 退出码 1 -> 修复问题后重新运行
+- 退出码 2 -> 停止并告知需要人工介入
+
+### 8. 告知用户
+
+输出：
+- 产物路径
+- PR 摘要同步结果
+- 当次完成校验输出
+- 下一步建议：继续 `commit` / `create-pr` 或进入最终审查流程
+
+渲染最终输出前，先读取 `.agents/rules/next-step-output.md`，并在绝对最后一行追加 `Completed at: YYYY-MM-DD HH:mm:ss`。
+
+## 完成检查清单
+
+- [ ] 已读取 `reference/summary-update.md`
+- [ ] 已创建人工验证产物
+- [ ] 已更新同一条 PR 摘要评论，或按失败语义停止
+- [ ] 已更新 task.md 并追加 Activity Log
+- [ ] 已运行完成校验

package/templates/.agents/skills/complete-manual-validation/config/verify.en.json

@@ -0,0 +1,49 @@
+{
+  "skill": "complete-manual-validation",
+  "checks": {
+    "task-meta": {
+      "required_fields": [
+        "id",
+        "type",
+        "workflow",
+        "status",
+        "created_at",
+        "updated_at",
+        "agent_infra_version",
+        "current_step",
+        "assigned_to"
+      ]
+    },
+    "artifact": {
+      "file_pattern": "manual-validation.md|manual-validation-r{N}.md",
+      "required_sections": [
+        "State Check",
+        "Validation Verdict",
+        "Validation Scope",
+        "Validation Details",
+        "PR Summary Sync"
+      ],
+      "freshness_minutes": 30,
+      "required_patterns": [
+        "^\\$ "
+      ]
+    },
+    "activity-log": {
+      "expected_action_pattern": "Complete Manual Validation",
+      "freshness_minutes": 30
+    },
+    "review-ledger": {
+      "stage_scope": ["analysis", "plan", "code"]
+    },
+    "platform-sync": {
+      "when": "pr_number_exists",
+      "expected_pr_comment_marker_key": "prSummary",
+      "expected_pr_comment_required_patterns": [
+        "^### ✅ Manual Validation Passed$"
+      ],
+      "verify_task_comment_content": true,
+      "verify_issue_type": true,
+      "verify_issue_fields": false
+    }
+  }
+}