@fitlab-ai/agent-infra 0.5.6 → 0.5.8

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

@@ -122,7 +122,7 @@ The script is responsible for:
 
 ### 9. Output Summary
 
-> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
+> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent. If `.agents/.airc.json` configures custom TUIs (via `customTUIs`), read each tool's `name` and `invoke`, then add the matching command line in the same format (`${skillName}` becomes the skill name and `${projectName}` becomes the project name).
 
 ```
 Release v{version} prepared.
@@ -146,6 +146,11 @@ Next steps (manual):
    - Claude Code / OpenCode: /create-release-note {version}
    - Gemini CLI: /{{project}}:create-release-note {version}
    - Codex CLI: $create-release-note {version}
+
+4. (Optional) Run post-release follow-up tasks:
+   - Claude Code / OpenCode: /post-release
+   - Gemini CLI: /{{project}}:post-release
+   - Codex CLI: $post-release
 ```
 
 ### Rollback Instructions

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

@@ -122,7 +122,7 @@ bash .agents/skills/release/scripts/manage-milestones.sh "$MAJOR" "$MINOR" "$PAT
 
 ### 9. 输出摘要
 
-> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。如果 `.agents/.airc.json` 中配置了自定义 TUI（`customTUIs`），读取每个工具的 `name` 和 `invoke`，按同样格式补充对应命令行（`${skillName}` 替换为技能名，`${projectName}` 替换为项目名）。
 
 ```
 版本 v{version} 已准备好发布。
@@ -146,6 +146,11 @@ bash .agents/skills/release/scripts/manage-milestones.sh "$MAJOR" "$MINOR" "$PAT
    - Claude Code / OpenCode：/create-release-note {version}
    - Gemini CLI：/{{project}}:create-release-note {version}
    - Codex CLI：$create-release-note {version}
+
+4.（可选）执行发布后处理：
+   - Claude Code / OpenCode：/post-release
+   - Gemini CLI：/{{project}}:post-release
+   - Codex CLI：$post-release
 ```
 
 ### 回滚说明

package/templates/.agents/skills/release/scripts/manage-milestones.sh

@@ -0,0 +1,6 @@
+#!/bin/sh
+
+set -e
+
+echo "Release milestone management skipped: this code platform does not provide a built-in milestone adapter." >&2
+exit 0

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

@@ -9,7 +9,7 @@ Restore local task workspace files from platform Issue comments that contain syn
 
 ## Boundary / Critical Rules
 
-- Restore files only from comments marked with `<!-- sync-issue:{task-id}:... -->`
+- Restore files only from comments that match the marker registry in `.agents/rules/issue-sync.md`
 - Restore into `.agents/workspace/active/{task-id}/` by default
 - Stop immediately if the target directory already exists and ask the user to resolve the conflict first
 - After executing this skill, you **must** immediately update the restored `task.md`
@@ -31,16 +31,11 @@ Read all Issue comments by following the "Read Issue comments" command in `.agen
 
 ### 3. Determine the task-id and Files to Restore
 
-Filter comments by these hidden markers:
-
-```html
-<!-- sync-issue:{task-id}:{file-stem} -->
-<!-- sync-issue:{task-id}:{file-stem}:{part}/{total} -->
-```
+Filter comments by the task, artifact, and chunked artifact markers defined in `.agents/rules/issue-sync.md`.
 
 Rules:
 - when `{task-id}` was provided, match only that task
-- when `{task-id}` was omitted, infer it from the `<!-- sync-issue:{task-id}:task -->` comment first
+- when `{task-id}` was omitted, infer it from the task comment marker first
 - if you cannot determine a unique task-id, stop and tell the user
 - ignore `summary` marker comments because they are complete-task aggregate output rather than restorable local task files
 - map `{file-stem}` back to filenames:
@@ -58,7 +53,7 @@ Read `.agents/rules/issue-sync.md` before executing this step.
 For each file:
 - collect its single comment or chunked comments
 - for `task.md` comments, reverse the `<details>` frontmatter wrapper described in issue-sync.md before reassembling the file body
-- when `{part}/{total}` exists, sort by part and verify the set is complete
+- when a chunk marker includes part and total indexes, sort by part and verify the set is complete
 - extract the file body by removing the hidden marker, heading, and footer
 - concatenate chunk bodies into the final file content
 
@@ -88,66 +83,20 @@ Update the restored `task.md`:
 - `status`: `active`
 - `assigned_to`: {current AI agent}
 - `updated_at`: {current time}
-- keep the original `current_step`
-- append this entry to `## Activity Log`:
-  ```
-  - {YYYY-MM-DD HH:mm:ss±HH:MM} — **Restore Task** by {agent} — Restored task from Issue #{issue-number}
-  ```
-
-### 7. Verification Gate
-
-Run the verification gate:
-
-```bash
-node .agents/scripts/validate-artifact.js gate restore-task .agents/workspace/active/{task-id} --format text
-```
-
-Handle the result as follows:
-- exit code 0 (all checks passed) -> continue to the "Inform User" step
-- exit code 1 (validation failed) -> fix the reported issues and run the gate again
-- exit code 2 (network blocked) -> stop and tell the user that human intervention is required
 
-Keep the gate output in your reply as fresh evidence. Do not claim completion without output from this run.
+Append an Activity Log entry indicating the task was restored from the platform Issue.
 
-### 8. Inform User
+### 7. Inform User
 
-> Execute this step only after the verification gate passes.
-
-> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
-
-Output format:
-
-```text
-Task {task-id} was restored from Issue #{issue-number}.
-
-Summary:
-- Restored files: {count}
-- Task directory: .agents/workspace/active/{task-id}/
-- Current step: {current_step}
-
-Next step - check task status:
-  - Claude Code / OpenCode: /check-task {task-id}
-  - Gemini CLI: /{{project}}:check-task {task-id}
-  - Codex CLI: $check-task {task-id}
-```
+Report the restored task id, restored file count, and the active task directory.
 
 ## Completion Checklist
 
-- [ ] Fetched and parsed Issue comments
-- [ ] Restored `task.md` and every available artifact file
-- [ ] Updated the restored task.md
-- [ ] Ran and passed the verification gate
-- [ ] Showed the next-step commands in every TUI format
-
-## STOP
-
-Stop after completing the checklist. Do not continue the workflow automatically.
+- [ ] Fetched Issue comments from the platform
+- [ ] Restored task files locally
+- [ ] Updated restored task metadata
+- [ ] Reported the restored directory
 
-## Error Handling
+### 8. Stop
 
-- Issue missing or inaccessible
-- Platform CLI unavailable or unauthenticated
-- No sync-marked comments found
-- Unable to determine a unique `task-id`
-- Target directory already exists
-- Missing chunks or incomplete chunk ordering
+Stop after the completion checklist. Do not commit automatically.

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

@@ -9,7 +9,7 @@ description: "从平台 Issue 评论还原本地任务文件"
 
 ## 行为边界 / 关键规则
 
-- 只从带 `<!-- sync-issue:{task-id}:... -->` 标记的评论恢复文件
+- 只从匹配 `.agents/rules/issue-sync.md` 标记注册表的评论恢复文件
 - 默认恢复到 `.agents/workspace/active/{task-id}/`
 - 如果目标目录已存在，立即停止并提示用户先处理目录冲突
 - 执行本技能后，你**必须**立即更新恢复出的 `task.md`
@@ -31,16 +31,11 @@ description: "从平台 Issue 评论还原本地任务文件"
 
 ### 3. 确定 task-id 与待恢复文件
 
-从评论中筛选隐藏标记：
-
-```html
-<!-- sync-issue:{task-id}:{file-stem} -->
-<!-- sync-issue:{task-id}:{file-stem}:{part}/{total} -->
-```
+按 `.agents/rules/issue-sync.md` 中定义的 task、artifact 和分片 artifact 标记筛选评论。
 
 处理规则：
 - 用户提供了 `{task-id}` 时，仅匹配该任务
-- 未提供时，优先从 `<!-- sync-issue:{task-id}:task -->` 评论推断
+- 未提供时，优先从 task 评论标记推断
 - 若找不到唯一 task-id，立即停止并告知用户
 - 忽略 `summary` 标记评论；它是 complete-task 的聚合产物，不对应本地任务文件
 - 将 `{file-stem}` 映射回文件名：
@@ -58,7 +53,7 @@ description: "从平台 Issue 评论还原本地任务文件"
 对每个文件执行：
 - 收集单条评论或分片评论
 - 对 `task.md` 评论按 issue-sync.md 中的 `<details>` frontmatter 格式反向拆解，提取 frontmatter 后再与正文拼合
-- 如存在 `{part}/{total}`，按 part 升序排序并校验分片完整
+- 如分片标记中存在 part 和 total 序号，按 part 升序排序并校验分片完整
 - 从评论正文中提取文件内容，去掉隐藏标记、标题和页脚
 - 拼接得到最终文件内容
 
@@ -88,66 +83,20 @@ date "+%Y-%m-%d %H:%M:%S%:z"
 - `status`：`active`
 - `assigned_to`：{当前 AI 代理}
 - `updated_at`：{当前时间}
-- 保留原 `current_step`
-- 在 `## 活动日志` 追加：
-  ```
-  - {YYYY-MM-DD HH:mm:ss±HH:MM} — **Restore Task** by {agent} — Restored task from Issue #{issue-number}
-  ```
-
-### 7. 完成校验
-
-运行完成校验：
-
-```bash
-node .agents/scripts/validate-artifact.js gate restore-task .agents/workspace/active/{task-id} --format text
-```
-
-处理结果：
-- 退出码 0（全部通过）-> 继续到「告知用户」步骤
-- 退出码 1（校验失败）-> 根据输出修复问题后重新运行校验
-- 退出码 2（网络中断）-> 停止执行并告知用户需要人工介入
 
-将校验输出保留在回复中作为当次验证输出。没有当次校验输出，不得声明完成。
+追加 Activity Log，说明任务已从平台 Issue 还原。
 
-### 8. 告知用户
+### 7. 告知用户
 
-> 仅在校验通过后执行本步骤。
-
-> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
-
-输出格式：
-
-```text
-任务 {task-id} 已从 Issue #{issue-number} 还原。
-
-摘要：
-- 恢复文件：{数量}
-- 任务目录：.agents/workspace/active/{task-id}/
-- 当前步骤：{current_step}
-
-下一步 - 查看任务状态：
-  - Claude Code / OpenCode：/check-task {task-id}
-  - Gemini CLI：/{{project}}:check-task {task-id}
-  - Codex CLI：$check-task {task-id}
-```
+报告已恢复的 task id、恢复文件数量和 active task 目录。
 
 ## 完成检查清单
 
-- [ ] 已获取并解析 Issue 评论
-- [ ] 已还原 `task.md` 和所有可用产物文件
-- [ ] 已更新恢复后的 task.md
-- [ ] 已运行并通过完成校验
-- [ ] 已向用户展示所有 TUI 格式的下一步命令
-
-## 停止
-
-完成检查清单后立即停止。不要自动继续执行工作流。
+- [ ] 已从平台获取 Issue 评论
+- [ ] 已恢复本地任务文件
+- [ ] 已更新恢复出的任务元数据
+- [ ] 已报告恢复目录
 
-## 错误处理
+### 8. 停止
 
-- Issue 不存在或无权访问
-- 平台 CLI 未认证
-- 找不到带 sync 标记的评论
-- 无法唯一确定 `task-id`
-- 目标目录已存在
-- 分片缺失或顺序不完整
+完成检查清单后立即停止。不要自动提交。

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

@@ -56,7 +56,7 @@ Update task.md and append:
 If task.md contains a valid `issue_number`, perform these sync actions (skip and continue on any failure):
 - Read `.agents/rules/issue-sync.md` before syncing, and complete upstream repository detection plus permission detection
 - Set `status: in-progress` by following issue-sync.md
-- Create or update the `<!-- sync-issue:{task-id}:task -->` comment (follow the task.md comment sync rule in issue-sync.md)
+- Create or update the task comment marker defined in `.agents/rules/issue-sync.md` (follow the task.md comment sync rule in issue-sync.md)
 - Publish the `{review-artifact}` comment
 
 ### 7. Verification Gate
@@ -86,7 +86,7 @@ Choose exactly one branch based on the findings:
 
 > The full four-branch output templates, selection rules, and prohibition clauses live in `reference/output-templates.md`. Read `reference/output-templates.md` before reporting the review result.
 
-Include all TUI command formats in the next-step output.
+Include all TUI command formats in the next-step output. If `.agents/.airc.json` configures custom TUIs (via `customTUIs`), read each tool's `name` and `invoke`, then add the matching command line in the same format (`${skillName}` becomes the skill name and `${projectName}` becomes the project name).
 
 ## Completion Checklist
 
@@ -94,7 +94,7 @@ Include all TUI command formats in the next-step output.
 - [ ] Created `{review-artifact}`
 - [ ] Updated task.md and appended the Activity Log entry
 - [ ] Chose exactly one verdict branch in the user output
-- [ ] Informed the user of the next step (must include all TUI command formats; do not filter)
+- [ ] Informed the user of the next step (must include all TUI command formats, including any custom TUIs; do not filter)
 
 ## Notes
 

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

@@ -56,7 +56,7 @@ date "+%Y-%m-%d %H:%M:%S%:z"
 如果 task.md 中存在有效的 `issue_number`，执行以下同步操作（任一失败则跳过并继续）：
 - 执行前先读取 `.agents/rules/issue-sync.md`，完成 upstream 仓库检测和权限检测
 - 按 issue-sync.md 设置 `status: in-progress`
-- 创建或更新 `<!-- sync-issue:{task-id}:task -->` 评论（按 issue-sync.md 的 task.md 评论同步规则）
+- 创建或更新 `.agents/rules/issue-sync.md` 中定义的 task 评论标记（按 issue-sync.md 的 task.md 评论同步规则）
 - 发布 `{review-artifact}` 评论
 
 ### 7. 完成校验
@@ -86,7 +86,7 @@ node .agents/scripts/validate-artifact.js gate review-task .agents/workspace/act
 
 > 完整的 4 分支输出模板、判断规则和禁止条款见 `reference/output-templates.md`。向用户汇报审查结论前先读取 `reference/output-templates.md`。
 
-向用户展示下一步时，必须包含所有 TUI 命令格式。
+向用户展示下一步时，必须包含所有 TUI 命令格式。如果 `.agents/.airc.json` 中配置了自定义 TUI（`customTUIs`），读取每个工具的 `name` 和 `invoke`，按同样格式补充对应命令行（`${skillName}` 替换为技能名，`${projectName}` 替换为项目名）。
 
 ## 完成检查清单
 
@@ -94,7 +94,7 @@ node .agents/scripts/validate-artifact.js gate review-task .agents/workspace/act
 - [ ] 已创建 `{review-artifact}`
 - [ ] 已更新 task.md 并追加 Activity Log
 - [ ] 用户输出中只选择了一个审查结论分支
-- [ ] 告知了用户下一步（必须展示所有 TUI 的命令格式，不要筛选）
+- [ ] 告知了用户下一步（必须展示所有 TUI 的命令格式，含自定义 TUI，不要筛选）
 
 ## 注意事项
 

package/templates/.agents/skills/review-task/config/verify.json

@@ -36,7 +36,9 @@
       "verify_comment_content": true,
       "verify_task_comment_content": true,
       "verify_issue_type": true,
-      "verify_milestone": true
+      "verify_milestone": true,
+      "expected_status_label_key": "inProgress",
+      "expected_comment_marker_key": "artifact"
     }
   }
 }

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

@@ -49,7 +49,7 @@ If tests fail:
 
 After tests pass, suggest committing the changes:
 
-> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
+> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent. If `.agents/.airc.json` configures custom TUIs (via `customTUIs`), read each tool's `name` and `invoke`, then add the matching command line in the same format (`${skillName}` becomes the skill name and `${projectName}` becomes the project name).
 
 ```
 Next step - commit changes:

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

@@ -49,7 +49,7 @@ description: "执行项目完整测试流程"
 
 测试通过后，建议提交变更：
 
-> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。如果 `.agents/.airc.json` 中配置了自定义 TUI（`customTUIs`），读取每个工具的 `name` 和 `invoke`，按同样格式补充对应命令行（`${skillName}` 替换为技能名，`${projectName}` 替换为项目名）。
 
 ```
 下一步 - 提交代码：

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

@@ -50,7 +50,7 @@ If tests fail:
 
 After tests pass, suggest committing the changes:
 
-> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
+> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent. If `.agents/.airc.json` configures custom TUIs (via `customTUIs`), read each tool's `name` and `invoke`, then add the matching command line in the same format (`${skillName}` becomes the skill name and `${projectName}` becomes the project name).
 
 ```
 Next step - commit changes:

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

@@ -50,7 +50,7 @@ description: "执行项目集成测试流程"
 
 测试通过后，建议提交变更：
 
-> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。如果 `.agents/.airc.json` 中配置了自定义 TUI（`customTUIs`），读取每个工具的 `name` 和 `invoke`，按同样格式补充对应命令行（`${skillName}` 替换为技能名，`${projectName}` 替换为项目名）。
 
 ```
 下一步 - 提交代码：

package/templates/.agents/skills/update-agent-infra/SKILL.en.md

@@ -24,7 +24,11 @@ Execute the following command to handle all deterministic steps at once:
 node .agents/skills/update-agent-infra/scripts/sync-templates.js
 ```
 
-The script reads `.agents/.airc.json`, automatically locates the installed `@fitlab-ai/agent-infra/templates/` directory via npm, and performs:
+The script reads `.agents/.airc.json` and automatically locates the installed
+`@fitlab-ai/agent-infra/templates/` directory via npm. Before syncing, it merges
+external template sources from `templates.sources`; built-in templates win over
+same-path external files, and later external sources win over earlier external
+sources. Conflicts are recorded in the report. The script then performs:
 - detect the template source version
 - File registry sync (`defaults.json` → `.agents/.airc.json`)
 - All managed files (language selection → exclude merged/ejected → placeholder rendering → overwrite)
@@ -37,7 +41,12 @@ The script outputs JSON to stdout. Parse and record the report.
 - `error`: error message (if non-empty, stop and report)
 - `templateVersion`: current template source version
 - `templateRoot`: absolute path to the template file root directory
+- `templateSources.conflicts`: external template source conflicts; explicitly
+  list these in the report so users know which files were ignored because a
+  built-in template or later external source won
 - `managed.written` / `managed.created`: updated / newly created managed files
+- `managed.removed`: deleted managed files (including old paths removed during template migrations)
+- `managed.skippedPlatform`: managed / merged entries skipped because they belong to a different platform
 - `merged.pending`: list of merged files for AI to process
   - Each item has `target` (project-relative path) and `template` (template-root-relative path)
 - `registryAdded`: newly added file registry entries
@@ -124,6 +133,7 @@ warning to the end of the report:
 Based on the script report and merged results, output a complete update report including:
 - Template version change
 - File registry additions
+- External template source conflicts, when `templateSources.conflicts` is non-empty
 - Managed file change details (updated, created, skipped merged files)
 - Merged file results (conflicts, remaining TODOs)
 - Ejected file processing
@@ -131,7 +141,7 @@ Based on the script report and merged results, output a complete update report i
 
 If there are changes to submit, add:
 
-> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
+> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent. If `.agents/.airc.json` configures custom TUIs (via `customTUIs`), read each tool's `name` and `invoke`, then add the matching command line in the same format (`${skillName}` becomes the skill name and `${projectName}` becomes the project name).
 
 ```
 Next step - commit changes:

package/templates/.agents/skills/update-agent-infra/SKILL.zh-CN.md

@@ -22,7 +22,7 @@ description: "更新项目 AI 协作配置"
 node .agents/skills/update-agent-infra/scripts/sync-templates.js
 ```
 
-脚本读取 `.agents/.airc.json`，并通过 npm 自动定位已安装的 `@fitlab-ai/agent-infra/templates/` 目录，然后自动完成：
+脚本读取 `.agents/.airc.json`，并通过 npm 自动定位已安装的 `@fitlab-ai/agent-infra/templates/` 目录。同步前会合并 `templates.sources` 中配置的外部模板源；相同文件以内置模板为准，多个外部源之间后者覆盖前者，冲突会写入报告。然后自动完成：
 - 检测模板源版本
 - 同步文件注册表（`defaults.json` → `.agents/.airc.json`）
 - 处理所有 managed 文件（语言选择 → 排除 merged/ejected → 占位符渲染 → 覆盖写入）
@@ -35,7 +35,10 @@ node .agents/skills/update-agent-infra/scripts/sync-templates.js
 - `error`：错误信息（如非空则停止并报告）
 - `templateVersion`：模板源当前版本
 - `templateRoot`：模板文件根目录绝对路径
+- `templateSources.conflicts`：外部模板源冲突列表；报告中必须显式展示，说明哪些文件因内置模板或后续外部源获胜而被忽略
 - `managed.written` / `managed.created`：已更新/新建的 managed 文件
+- `managed.removed`：被删除的 managed 文件（包括模板迁移时移除的旧路径）
+- `managed.skippedPlatform`：因归属其他平台而被跳过的 managed / merged 条目
 - `merged.pending`：需要 AI 处理的 merged 文件列表
   - 每项包含 `target`（项目中的目标路径）和 `template`（模板根目录下的相对路径）
 - `registryAdded`：新增的文件注册条目
@@ -114,6 +117,7 @@ node .agents/skills/update-agent-infra/scripts/sync-templates.js
 基于脚本报告和 merged 合并结果，输出完整的更新报告，包括：
 - 模板版本变更
 - 文件注册表新增条目
+- 外部模板源冲突（如 `templateSources.conflicts` 非空，必须逐项列出）
 - managed 文件变更明细（已更新、新建、跳过的 merged 文件）
 - merged 文件合并结果（冲突、残余 TODO）
 - ejected 文件处理
@@ -121,7 +125,7 @@ node .agents/skills/update-agent-infra/scripts/sync-templates.js
 
 如有变更需要提交，追加：
 
-> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。如果 `.agents/.airc.json` 中配置了自定义 TUI（`customTUIs`），读取每个工具的 `name` 和 `invoke`，按同样格式补充对应命令行（`${skillName}` 替换为技能名，`${projectName}` 替换为项目名）。
 
 ```
 下一步 - 提交代码：