@fitlab-ai/agent-infra 0.3.2 → 0.4.0

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

@@ -30,7 +30,26 @@ git status --short
 
 如果有未提交的变更，报错："Workspace has uncommitted changes. Please commit or stash first."
 
-### 步骤 3：更新版本引用
+### 步骤 3：发布前验证
+
+<!-- TODO: 替换为你的项目发布前验证步骤 -->
+
+运行所有在准备发布前必须通过的检查：
+
+```bash
+git branch --show-current
+# TODO: 替换为你的项目测试/构建验证命令
+```
+
+验证要求：
+- 确认发布使用的是项目规定的分支
+- 运行你的发布流程要求的完整校验命令
+
+处理规则：
+- 如果当前分支不符合预期，按项目策略输出警告或直接退出
+- 如果任何验证命令失败，停止发布流程并先修复问题
+
+### 步骤 4：更新版本引用
 
 <!-- TODO: 替换为你的项目版本更新步骤 -->
 
@@ -44,6 +63,7 @@ git status --short
 
 **常见需要更新的文件**：
 - `package.json`（Node.js）
+- `package-lock.json`（Node.js；更新 `package.json` 后运行 `npm install --package-lock-only` 同步锁文件）
 - `pom.xml`（Maven）
 - `setup.py` / `pyproject.toml`（Python）
 - `version.go`（Go）
@@ -51,22 +71,39 @@ git status --short
 - `SECURITY.md` / `SECURITY.zh-CN.md`（支持版本表格）
 
 **排除以下目录的版本替换**：
-- `.agents/`、`.agent-workspace/`、`.claude/`、`.codex/`、`.gemini/`、`.opencode/`（AI 工具配置）
+- `.agents/`、`.agents/workspace/`、`.claude/`、`.codex/`、`.gemini/`、`.opencode/`（AI 工具配置）
+
+如果项目使用 `package-lock.json`，在更新 `package.json` 后运行 `npm install --package-lock-only`，确保锁文件中的版本号保持同步。
+
+### 步骤 5：重新生成构建产物
 
-### 步骤 4：创建发布提交
+<!-- TODO: 替换为你的项目产物重建步骤 -->
+
+如果版本更新会影响生成文件、内嵌元数据或打包产物，现在重新生成它们：
+
+```bash
+# TODO: 替换为你的项目构建/重建命令
+```
+
+执行要求：
+- 在更新版本引用后运行，确保生成产物使用最新版本号
+- 如果项目没有生成产物，请在项目特化版本中明确说明
+- 如果重建失败，停止发布流程并先修复构建问题
+
+### 步骤 6：创建发布提交
 
 ```bash
 git add -A
 git commit -m "chore: release v{version}"
 ```
 
-### 步骤 5：创建 Git 标签
+### 步骤 7：创建 Git 标签
 
 ```bash
 git tag v{version}
 ```
 
-### 步骤 6：管理里程碑
+### 步骤 8：管理里程碑
 
 为已发布版本关闭对应版本里程碑，并为下一轮创建缺失的规划里程碑。
 
@@ -83,7 +120,7 @@ bash .agents/skills/release/scripts/manage-milestones.sh "$MAJOR" "$MINOR" "$PAT
 - 当 `PATCH=0` 时，同时确保 `{MAJOR}.{MINOR+1}.0` 与 `{MAJOR}.{MINOR+1}.x`
 - 输出包含已发布里程碑动作和新建数量的汇总
 
-### 步骤 7：输出摘要
+### 步骤 9：输出摘要
 
 > **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
 
@@ -99,12 +136,12 @@ bash .agents/skills/release/scripts/manage-milestones.sh "$MAJOR" "$MINOR" "$PAT
 
 下一步（手动执行）：
 
-1. 推送标签：
-   git push origin v{version}
-
-2. 推送分支：
+1. 推送分支：
    git push origin {current-branch}
 
+2. 推送标签：
+   git push origin v{version}
+
 3.（可选）生成发布说明：
    - Claude Code / OpenCode：/create-release-note {version}
    - Gemini CLI：/{{project}}:create-release-note {version}
@@ -129,13 +166,17 @@ git checkout -- .
 
 1. **需要干净的工作区**：必须没有未提交的变更
 2. **不自动推送**：所有操作仅在本地执行；用户手动推送
-3. **不验证构建**：发布前执行 test 技能进行验证
-4. **版本替换范围**：通过搜索确定需要更新哪些文件；排除 AI 工具目录
-5. **适配你的项目**：以上版本更新步骤是通用的；请根据你的项目版本方案进行定制
-6. **里程碑联动**：发布时自动创建下一轮里程碑；如果里程碑体系未初始化，建议先运行 `init-milestones`
+3. **发布前验证**：将步骤 3 的 TODO 替换为你的项目所需的分支、测试和验证命令
+4. **生成产物**：如果版本变化会影响生成文件、打包产物或内嵌元数据，需要将步骤 5 的 TODO 替换为实际命令
+5. **发布自动化**：如果推送标签会触发 CI/CD 或包发布，请先确认所需凭据和流水线配置
+6. **版本替换范围**：通过搜索确定需要更新哪些文件；排除 AI 工具目录
+7. **适配你的项目**：以上版本更新和产物重建步骤是通用的；请根据你的项目版本方案进行定制
+8. **里程碑联动**：发布时自动创建下一轮里程碑；如果里程碑体系未初始化，建议先运行 `init-milestones`
 
 ## 错误处理
 
 - 版本格式无效：提示正确格式并退出
 - 工作区不干净：提示提交或暂存
+- 验证失败：显示失败的检查并停止发布流程
+- 产物重建失败：显示构建错误并停止发布流程
 - Git 操作失败：显示错误并提供回滚说明

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

@@ -18,7 +18,7 @@ description: >
 ### 1. Verify Prerequisites
 
 Check required files:
-- `.agent-workspace/active/{task-id}/task.md` - Task file
+- `.agents/workspace/active/{task-id}/task.md` - Task file
 - At least one implementation report: `implementation.md` or `implementation-r{N}.md`
 
 Note: `{task-id}` format is `TASK-{yyyyMMdd-HHmmss}`, for example `TASK-20260306-143022`
@@ -27,7 +27,7 @@ If either file is missing, prompt the user to complete the prerequisite step fir
 
 ### 2. Determine Review Round
 
-Scan review artifacts in `.agent-workspace/active/{task-id}/`:
+Scan review artifacts in `.agents/workspace/active/{task-id}/`:
 - If neither `review.md` nor `review-r*.md` exists -> this is Round 1 and must create `review.md`
 - If `review.md` exists and no `review-r*.md` exists -> this is Round 2 and must create `review-r2.md`
 - If `review-r{N}.md` exists -> this is Round N+1 and must create `review-r{N+1}.md`
@@ -56,7 +56,7 @@ Follow the `code-review` step in `.agents/workflows/feature-development.yaml`:
 **Required review areas**:
 - [ ] Code quality and coding standards (per project instructions)
 - [ ] Bug and risk detection
-- [ ] Test coverage and test quality
+- [ ] Test coverage and test quality (when a feature is removed, verify that test fixtures and assertions for that feature are also removed — not mechanically flipped; assertions that only confirm data passes through unchanged are not valid tests)
 - [ ] Error handling and edge cases
 - [ ] Performance and security concerns
 - [ ] Code comments and documentation
@@ -72,7 +72,7 @@ Also review `git diff` to inspect the full context of all changes.
 
 ### 5. Output Review Report
 
-Create `.agent-workspace/active/{task-id}/{review-artifact}`.
+Create `.agents/workspace/active/{task-id}/{review-artifact}`.
 
 ### 6. Update Task Status
 
@@ -82,7 +82,7 @@ Get the current time:
 date "+%Y-%m-%d %H:%M:%S"
 ```
 
-Update `.agent-workspace/active/{task-id}/task.md`:
+Update `.agents/workspace/active/{task-id}/task.md`:
 - `current_step`: code-review
 - `assigned_to`: {reviewer}
 - `updated_at`: {current time}
@@ -123,7 +123,7 @@ Next step - commit changes:
 ```
 Code review complete for task {task-id}. Verdict: Approved.
 - Blockers: 0 | Major issues: {n} | Minor issues: {n}
-- Review report: .agent-workspace/active/{task-id}/{review-artifact}
+- Review report: .agents/workspace/active/{task-id}/{review-artifact}
 
 Next step - fix issues before commit (recommended):
   - Claude Code / OpenCode: /refine-task {task-id}
@@ -140,7 +140,7 @@ Or commit directly (skip fixes):
 ```
 Code review complete for task {task-id}. Verdict: Changes Requested.
 - Blockers: {n} | Major issues: {n} | Minor issues: {n}
-- Review report: .agent-workspace/active/{task-id}/{review-artifact}
+- Review report: .agents/workspace/active/{task-id}/{review-artifact}
 
 Next step - refine the issues:
   - Claude Code / OpenCode: /refine-task {task-id}
@@ -151,7 +151,7 @@ Next step - refine the issues:
 **📋 Output Branch D - Rejected** (Condition: major rework, redesign, or re-implementation is required):
 ```
 Code review complete for task {task-id}. Verdict: Rejected, major rework required.
-- Review report: .agent-workspace/active/{task-id}/{review-artifact}
+- Review report: .agents/workspace/active/{task-id}/{review-artifact}
 
 Next step - re-implement:
   - Claude Code / OpenCode: /implement-task {task-id}
@@ -264,7 +264,7 @@ Next step - re-implement:
 ## Completion Checklist
 
 - [ ] Completed code review for all modified files
-- [ ] Created review report `.agent-workspace/active/{task-id}/{review-artifact}`
+- [ ] Created review report `.agents/workspace/active/{task-id}/{review-artifact}`
 - [ ] Updated `current_step` to code-review in task.md
 - [ ] Updated `updated_at` to the current time in task.md
 - [ ] Updated `assigned_to` to the reviewer name in task.md

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

@@ -17,7 +17,7 @@ description: >
 ### 1. 验证前置条件
 
 检查必要文件：
-- `.agent-workspace/active/{task-id}/task.md` - 任务文件
+- `.agents/workspace/active/{task-id}/task.md` - 任务文件
 - 至少一个实现报告：`implementation.md` 或 `implementation-r{N}.md`
 
 注意：`{task-id}` 格式为 `TASK-{yyyyMMdd-HHmmss}`，例如 `TASK-20260306-143022`
@@ -26,7 +26,7 @@ description: >
 
 ### 2. 确定审查轮次
 
-扫描 `.agent-workspace/active/{task-id}/` 目录中的审查产物文件：
+扫描 `.agents/workspace/active/{task-id}/` 目录中的审查产物文件：
 - 如果不存在 `review.md` 且不存在 `review-r*.md` → 本轮为第 1 轮，产出 `review.md`
 - 如果存在 `review.md` 且不存在 `review-r*.md` → 本轮为第 2 轮，产出 `review-r2.md`
 - 如果存在 `review-r{N}.md` → 本轮为第 N+1 轮，产出 `review-r{N+1}.md`
@@ -55,7 +55,7 @@ description: >
 **必要审查领域**：
 - [ ] 代码质量和编码规范（按项目指南）
 - [ ] Bug 和潜在问题检测
-- [ ] 测试覆盖率和测试质量
+- [ ] 测试覆盖率和测试质量（删除功能时，确认为该功能而存在的测试 fixture 和断言已一并删除，而非机械翻转断言方向；仅确认数据原样通过的断言不构成有效测试）
 - [ ] 错误处理和边界情况
 - [ ] 性能和安全问题
 - [ ] 代码注释和文档
@@ -71,7 +71,7 @@ description: >
 
 ### 5. 输出审查报告
 
-创建 `.agent-workspace/active/{task-id}/{review-artifact}`。
+创建 `.agents/workspace/active/{task-id}/{review-artifact}`。
 
 ### 6. 更新任务状态
 
@@ -81,7 +81,7 @@ description: >
 date "+%Y-%m-%d %H:%M:%S"
 ```
 
-更新 `.agent-workspace/active/{task-id}/task.md`：
+更新 `.agents/workspace/active/{task-id}/task.md`：
 - `current_step`：code-review
 - `assigned_to`：{审查者}
 - `updated_at`：{当前时间}
@@ -122,7 +122,7 @@ date "+%Y-%m-%d %H:%M:%S"
 ```
 任务 {task-id} 代码审查完成。结论：通过。
 - 阻塞项：0 | 主要问题：{n} | 次要问题：{n}
-- 审查报告：.agent-workspace/active/{task-id}/{review-artifact}
+- 审查报告：.agents/workspace/active/{task-id}/{review-artifact}
 
 下一步 - 修复问题后提交（推荐）：
   - Claude Code / OpenCode：/refine-task {task-id}
@@ -139,7 +139,7 @@ date "+%Y-%m-%d %H:%M:%S"
 ```
 任务 {task-id} 代码审查完成。结论：需要修改。
 - 阻塞项：{n} | 主要问题：{n} | 次要问题：{n}
-- 审查报告：.agent-workspace/active/{task-id}/{review-artifact}
+- 审查报告：.agents/workspace/active/{task-id}/{review-artifact}
 
 下一步 - 修复问题：
   - Claude Code / OpenCode：/refine-task {task-id}
@@ -150,7 +150,7 @@ date "+%Y-%m-%d %H:%M:%S"
 **📋 输出分支 D — 拒绝**（条件：需要重大返工、重新设计或重新实现）：
 ```
 任务 {task-id} 代码审查完成。结论：拒绝，需要重大返工。
-- 审查报告：.agent-workspace/active/{task-id}/{review-artifact}
+- 审查报告：.agents/workspace/active/{task-id}/{review-artifact}
 
 下一步 - 重新实现：
   - Claude Code / OpenCode：/implement-task {task-id}
@@ -263,7 +263,7 @@ date "+%Y-%m-%d %H:%M:%S"
 ## 完成检查清单
 
 - [ ] 完成了所有修改文件的代码审查
-- [ ] 创建了审查报告 `.agent-workspace/active/{task-id}/{review-artifact}`
+- [ ] 创建了审查报告 `.agents/workspace/active/{task-id}/{review-artifact}`
 - [ ] 更新了 task.md 中的 `current_step` 为 code-review
 - [ ] 更新了 task.md 中的 `updated_at` 为当前时间
 - [ ] 更新了 task.md 中的 `assigned_to` 为审查者名称

package/templates/.agents/skills/sync-issue/SKILL.md

@@ -18,17 +18,17 @@ Identify the argument provided by the user:
 - plain number (`123`) or `#` + number (`#123`) -> treat as an issue number
 - Starts with `TASK-` -> treat as a task-id (current format)
 
-If the argument is an issue number, use Bash to search for the related task (note: `.agent-workspace` is a hidden directory, so Grep/Glob tools may skip it; you must use Bash):
+If the argument is an issue number, use Bash to search for the related task (note: `.agents/workspace` is a hidden directory, so Grep/Glob tools may skip it; you must use Bash):
 
 ```bash
 grep -rl "^issue_number: {issue-number}$" \
-  .agent-workspace/active/ \
-  .agent-workspace/blocked/ \
-  .agent-workspace/completed/ \
+  .agents/workspace/active/ \
+  .agents/workspace/blocked/ \
+  .agents/workspace/completed/ \
   2>/dev/null | head -1
 ```
 
-- If a file path is returned (for example `.agent-workspace/completed/TASK-xxx/task.md`), extract `{task-id}` and the task directory from the path, then continue to Step 2
+- If a file path is returned (for example `.agents/workspace/completed/TASK-xxx/task.md`), extract `{task-id}` and the task directory from the path, then continue to Step 2
 - If nothing is returned, output `No task found associated with Issue #{issue-number}`
 
 If the argument is a task-id, continue with the normal Step 2 flow.
@@ -36,9 +36,9 @@ If the argument is a task-id, continue with the normal Step 2 flow.
 ### 2. Verify the Task Exists
 
 For a `task-id`, search for the task in this order:
-- `.agent-workspace/active/{task-id}/task.md`
-- `.agent-workspace/blocked/{task-id}/task.md`
-- `.agent-workspace/completed/{task-id}/task.md`
+- `.agents/workspace/active/{task-id}/task.md`
+- `.agents/workspace/blocked/{task-id}/task.md`
+- `.agents/workspace/completed/{task-id}/task.md`
 
 Note: `{task-id}` format is `TASK-{yyyyMMdd-HHmmss}`, for example `TASK-20260306-143022`
 

package/templates/.agents/skills/sync-issue/SKILL.zh-CN.md

@@ -17,17 +17,17 @@ description: >
 - 纯数字（如 `123`）或 `#` + 数字（如 `#123`）-> 视为 issue number
 - `TASK-` 开头 -> 视为 task-id（现有格式）
 
-如果参数是 issue number，使用 Bash 搜索关联任务（注意：`.agent-workspace` 是隐藏目录，Grep/Glob 工具会跳过，必须使用 Bash）：
+如果参数是 issue number，使用 Bash 搜索关联任务（注意：`.agents/workspace` 是隐藏目录，Grep/Glob 工具会跳过，必须使用 Bash）：
 
 ```bash
 grep -rl "^issue_number: {issue-number}$" \
-  .agent-workspace/active/ \
-  .agent-workspace/blocked/ \
-  .agent-workspace/completed/ \
+  .agents/workspace/active/ \
+  .agents/workspace/blocked/ \
+  .agents/workspace/completed/ \
   2>/dev/null | head -1
 ```
 
-- 如果返回文件路径（如 `.agent-workspace/completed/TASK-xxx/task.md`），从路径中提取 `{task-id}` 和任务目录，继续执行步骤 2
+- 如果返回文件路径（如 `.agents/workspace/completed/TASK-xxx/task.md`），从路径中提取 `{task-id}` 和任务目录，继续执行步骤 2
 - 如果无返回，提示 `No task found associated with Issue #{issue-number}`
 
 如果参数是 task-id，继续执行步骤 2 的现有逻辑。
@@ -35,9 +35,9 @@ grep -rl "^issue_number: {issue-number}$" \
 ### 2. 验证任务存在
 
 对于 `task-id` 路径，按优先顺序搜索任务：
-- `.agent-workspace/active/{task-id}/task.md`
-- `.agent-workspace/blocked/{task-id}/task.md`
-- `.agent-workspace/completed/{task-id}/task.md`
+- `.agents/workspace/active/{task-id}/task.md`
+- `.agents/workspace/blocked/{task-id}/task.md`
+- `.agents/workspace/completed/{task-id}/task.md`
 
 注意：`{task-id}` 格式为 `TASK-{yyyyMMdd-HHmmss}`，例如 `TASK-20260306-143022`
 

package/templates/.agents/skills/sync-pr/SKILL.md

@@ -14,9 +14,9 @@ Sync task progress to the related Pull Request. Argument: task-id.
 ### 1. Verify the Task Exists
 
 Search for the task in this order:
-- `.agent-workspace/active/{task-id}/task.md`
-- `.agent-workspace/completed/{task-id}/task.md`
-- `.agent-workspace/blocked/{task-id}/task.md`
+- `.agents/workspace/active/{task-id}/task.md`
+- `.agents/workspace/completed/{task-id}/task.md`
+- `.agents/workspace/blocked/{task-id}/task.md`
 
 Note: `{task-id}` format is `TASK-{yyyyMMdd-HHmmss}`, for example `TASK-20260306-143022`
 

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

@@ -14,9 +14,9 @@ description: >
 ### 1. 验证任务存在
 
 按优先顺序搜索任务：
-- `.agent-workspace/active/{task-id}/task.md`
-- `.agent-workspace/completed/{task-id}/task.md`
-- `.agent-workspace/blocked/{task-id}/task.md`
+- `.agents/workspace/active/{task-id}/task.md`
+- `.agents/workspace/completed/{task-id}/task.md`
+- `.agents/workspace/blocked/{task-id}/task.md`
 
 注意：`{task-id}` 格式为 `TASK-{yyyyMMdd-HHmmss}`，例如 `TASK-20260306-143022`
 

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

@@ -28,12 +28,12 @@ Execute the following command to handle all deterministic steps at once:
 node .agents/skills/update-agent-infra/scripts/sync-templates.js
 ```
 
-The script reads `.airc.json` (including `templateSource`, default `templates/`) and automatically performs:
-- git pull to fetch latest templates
-- File registry sync (`defaults.json` → `.airc.json`)
+The script reads `.agents/.airc.json` (including `templateSource`, default `templates/`) and automatically 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)
 - Ejected files (create only on first install)
-- `.airc.json` update (`templateVersion`, file lists)
+- `.agents/.airc.json` update (`templateVersion`, file lists)
 
 The script outputs JSON to stdout. Parse and record the report.
 
@@ -46,14 +46,14 @@ The script outputs JSON to stdout. Parse and record the report.
   - Each item has `target` (project-relative path) and `template` (template-root-relative path)
 - `registryAdded`: newly added file registry entries
 - `selfUpdate`: whether this is a self-update scenario
-- `configUpdated`: whether `.airc.json` was updated
+- `configUpdated`: whether `.agents/.airc.json` was updated
 
 ## Phase B: Process merged files (AI intelligent merge)
 
 Process each item in the report's `merged.pending` list:
 
 1. Read the template file from `<templateRoot>/<template>`
-2. Render placeholders: replace double-brace `project` and `org` placeholders with actual values from .airc.json
+2. Render placeholders: replace double-brace `project` and `org` placeholders with actual values from .agents/.airc.json
 3. Read the current local file (`<project-root>/<target>`)
 
 **If the local file does not exist** (first-time setup), write the rendered

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

@@ -24,12 +24,12 @@ description: >
 node .agents/skills/update-agent-infra/scripts/sync-templates.js
 ```
 
-脚本读取 `.airc.json`（含 `templateSource`，默认 `templates/`），自动完成：
-- git pull 拉取最新模板
-- 同步文件注册表（`defaults.json` → `.airc.json`）
+脚本读取 `.agents/.airc.json`（含 `templateSource`，默认 `templates/`），自动完成：
+- 检测模板源版本
+- 同步文件注册表（`defaults.json` → `.agents/.airc.json`）
 - 处理所有 managed 文件（语言选择 → 排除 merged/ejected → 占位符渲染 → 覆盖写入）
 - 处理 ejected 文件（仅首次安装时创建）
-- 更新 `.airc.json`（`templateVersion`、文件列表）
+- 更新 `.agents/.airc.json`（`templateVersion`、文件列表）
 
 脚本输出 JSON 到 stdout，解析并记录报告内容。
 
@@ -42,14 +42,14 @@ node .agents/skills/update-agent-infra/scripts/sync-templates.js
   - 每项包含 `target`（项目中的目标路径）和 `template`（模板根目录下的相对路径）
 - `registryAdded`：新增的文件注册条目
 - `selfUpdate`：是否为自更新模式
-- `configUpdated`：`.airc.json` 是否已更新
+- `configUpdated`：`.agents/.airc.json` 是否已更新
 
 ## 阶段 B：处理 merged 文件（AI 智能合并）
 
 根据报告中 `merged.pending` 列表，逐个文件处理。对于每个条目：
 
 1. 从 `<templateRoot>/<template>` 读取模板文件
-2. 渲染占位符：将双花括号包裹的 `project` 和 `org` 占位符替换为 .airc.json 中的实际值
+2. 渲染占位符：将双花括号包裹的 `project` 和 `org` 占位符替换为 .agents/.airc.json 中的实际值
 3. 读取本地当前文件（`<项目根>/<target>`）
 
 **如果本地文件不存在**（首次安装），直接写入渲染后的模板，跳过合并。