@fitlab-ai/agent-infra 0.3.2 → 0.4.1

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

@@ -1,10 +1,6 @@
 ---
 name: update-agent-infra
-description: >
-  Update the current project's AI collaboration infrastructure
-  and project governance to match the latest agent-infra
-  templates. Intelligently merges template changes while
-  preserving project-specific customizations.
+description: "Update the project AI collaboration configuration"
 ---
 
 # Update Project
@@ -28,12 +24,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`, automatically locates the installed `@fitlab-ai/agent-infra/templates/` directory via npm, and 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 +42,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

@@ -1,8 +1,6 @@
 ---
 name: update-agent-infra
-description: >
-  更新当前项目的 AI 协作基础设施和项目治理配置，使其与最新的 agent-infra 模板保持一致。
-  智能合并模板变更，同时保留项目特定的定制内容。
+description: "更新项目 AI 协作配置"
 ---
 
 # 更新项目
@@ -24,12 +22,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`，并通过 npm 自动定位已安装的 `@fitlab-ai/agent-infra/templates/` 目录，然后自动完成：
+- 检测模板源版本
+- 同步文件注册表（`defaults.json` → `.agents/.airc.json`）
 - 处理所有 managed 文件（语言选择 → 排除 merged/ejected → 占位符渲染 → 覆盖写入）
 - 处理 ejected 文件（仅首次安装时创建）
-- 更新 `.airc.json`（`templateVersion`、文件列表）
+- 更新 `.agents/.airc.json`（`templateVersion`、文件列表）
 
 脚本输出 JSON 到 stdout，解析并记录报告内容。
 
@@ -42,14 +40,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>`）
 
 **如果本地文件不存在**（首次安装），直接写入渲染后的模板，跳过合并。

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

@@ -2,8 +2,8 @@
 /**
  * sync-templates.js — Deterministic template sync for managed & ejected files.
  *
- * Handles SKILL steps: 2 (git pull), 3.0 (registry sync), 4 (managed),
- * 6 (ejected), 7 (.airc.json update).
+ * Handles SKILL steps: 2 (detect template source version), 3.0 (registry sync), 4 (managed),
+ * 6 (ejected), 7 (.agents/.airc.json update).
  *
  * Merged files (step 5) are NOT handled — they require AI semantic merge.
  * The report includes `merged.pending` so the AI knows what to process.
@@ -16,39 +16,20 @@
 
 import childProcess from 'node:child_process';
 import fs from 'node:fs';
-import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-// Keep these helpers aligned with lib/paths.js for clone installs.
-function resolveInstallDir() {
-  return path.join(os.homedir(), '.agent-infra');
-}
-
-function resolveTemplateDir() {
-  const clonePath = path.join(resolveInstallDir(), 'templates');
-  if (fs.existsSync(clonePath)) {
-    return clonePath;
-  }
-
-  return null;
-}
-
 const DEFAULTS = {
   "files": {
     "managed": [
       ".agents/skills/",
       ".agents/templates/",
       ".agents/workflows/",
-      ".agent-workspace/README.md",
+      ".agents/workspace/README.md",
       ".claude/commands/",
-      ".editorconfig",
+      ".claude/hooks/",
       ".gemini/commands/",
-      ".github/hooks/",
-      ".github/ISSUE_TEMPLATE/",
-      ".github/PULL_REQUEST_TEMPLATE.md",
-      ".github/release.yml",
-      ".github/workflows/pr-title-check.yml",
+      ".github/hooks/check-version-format.sh",
       ".opencode/commands/"
     ],
     "merged": [
@@ -67,20 +48,17 @@ const DEFAULTS = {
       ".claude/settings.json",
       ".codex/README.md",
       ".gemini/settings.json",
-      ".github/dependabot.yml",
+      ".github/hooks/pre-commit",
       ".gitignore",
-      ".mailmap",
       ".opencode/COMMAND_STYLE_GUIDE.md",
       ".opencode/README.md",
-      "AGENTS.md",
-      "CONTRIBUTING.md",
-      "SECURITY.md"
+      "AGENTS.md"
     ],
     "ejected": []
   }
 };
 
-const INSTALLER_VERSION = "v0.3.2";
+const INSTALLER_VERSION = "v0.4.1";
 
 function norm(p) { return p.replace(/\\/g, '/'); }
 
@@ -138,32 +116,42 @@ function renderPathname(p, project) {
   return p.replace(/_project_/g, project);
 }
 
-function resolveProjectTemplateDir(projectRoot, templateSource) {
-  const fallbackRoot = resolveTemplateDir();
-
-  const candidates = [];
-  if (templateSource) {
-    if (path.isAbsolute(templateSource)) {
-      candidates.push(templateSource);
-    } else {
-      if (fallbackRoot) {
-        candidates.push(path.resolve(path.dirname(fallbackRoot), templateSource));
-      }
-      candidates.push(path.resolve(projectRoot, templateSource));
-    }
+function isTemplateDir(dir) {
+  try {
+    return fs.statSync(dir).isDirectory();
+  } catch {
+    return false;
   }
-  if (fallbackRoot) {
-    candidates.push(fallbackRoot);
+}
+
+function resolveInstalledTemplateDir(nodeModulesRoot) {
+  if (!nodeModulesRoot) return null;
+  const candidate = path.join(nodeModulesRoot, '@fitlab-ai', 'agent-infra', 'templates');
+  return isTemplateDir(candidate) ? candidate : null;
+}
+
+function resolveTemplateRoot(projectRoot) {
+  try {
+    const globalRoot = childProcess.execSync('npm root -g', {
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'pipe']
+    }).trim();
+    const globalTemplateRoot = resolveInstalledTemplateDir(globalRoot);
+    if (globalTemplateRoot) return globalTemplateRoot;
+  } catch {
+    // npm may be unavailable or not configured.
   }
 
-  for (const candidate of candidates) {
-    try {
-      if (fs.statSync(candidate).isDirectory()) {
-        return candidate;
-      }
-    } catch {
-      // Keep scanning until a valid directory is found.
-    }
+  try {
+    const localRoot = childProcess.execSync('npm root', {
+      cwd: projectRoot,
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'pipe']
+    }).trim();
+    const localTemplateRoot = resolveInstalledTemplateDir(localRoot);
+    if (localTemplateRoot) return localTemplateRoot;
+  } catch {
+    // npm may be unavailable or the project may not have a local install.
   }
 
   return null;
@@ -179,15 +167,6 @@ function isBinary(fp) {
   return false;
 }
 
-function fileModule(rel) {
-  const p = norm(rel);
-  if (p.startsWith('.github/')) return 'github';
-  if (p.startsWith('.agents/') || p.startsWith('.claude/') ||
-      p.startsWith('.gemini/') || p.startsWith('.opencode/') ||
-      p.startsWith('.codex/') || p === 'AGENTS.md') return 'ai';
-  return null;
-}
-
 function gitUrl(dir) {
   try {
     return childProcess.execSync('git remote get-url origin', {
@@ -196,9 +175,6 @@ function gitUrl(dir) {
   } catch { return null; }
 }
 
-// Public-facing docs should keep all available language variants in sync.
-const MULTI_LANG = new Set(['SECURITY.md']);
-
 function langSelect(rels, lang, allSet, project) {
   const sel = new Map();
 
@@ -226,45 +202,24 @@ function langSelect(rels, lang, allSet, project) {
   return sel;
 }
 
-function syncTemplates(projectRoot) {
-  const cfgPath = path.join(projectRoot, '.airc.json');
+function syncTemplates(projectRoot, templateRootOverride) {
+  const configDir = path.join(projectRoot, '.agents');
+  const cfgPath = path.join(configDir, '.airc.json');
+
   if (!fs.existsSync(cfgPath)) {
-    return { error: 'No .airc.json in project root.' };
+    return { error: 'No .agents/.airc.json in project root.' };
   }
 
   const cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
-  const templateRoot = resolveProjectTemplateDir(projectRoot, cfg.templateSource);
+  const configPathRel = norm(path.relative(projectRoot, cfgPath));
+  const templateRoot = templateRootOverride || resolveTemplateRoot(projectRoot);
   if (!templateRoot) {
-    return { error: 'Template source not found. Install: curl -fsSL https://raw.githubusercontent.com/fitlab-ai/agent-infra/main/install.sh | sh' };
+    return { error: 'Template source not found. Install via npm: npm install -g @fitlab-ai/agent-infra' };
   }
-  const installDir = resolveInstallDir();
+  const version = INSTALLER_VERSION;
+  const hadTemplateSource = Object.prototype.hasOwnProperty.call(cfg, 'templateSource');
 
-  const hasGit = fs.existsSync(path.join(installDir, '.git'));
-  if (hasGit) {
-    try { childProcess.execSync('git fetch --tags --quiet', { cwd: installDir, stdio: 'pipe' }); } catch { /* network */ }
-  }
-
-  let version = 'unknown';
-  if (hasGit) {
-    let tagOutput;
-    try {
-      tagOutput = childProcess.execSync('git tag --sort=-v:refname', {
-        cwd: installDir, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe']
-      }).trim();
-    } catch {
-      return { error: 'Failed to list tags in agent-infra repository. Please check git installation.' };
-    }
-    const latestTag = tagOutput.split('\n')[0];
-    if (!latestTag) {
-      return { error: 'No tags found in agent-infra repository. This is unexpected — please reinstall.' };
-    }
-    try { childProcess.execFileSync('git', ['checkout', latestTag, '--quiet'], { cwd: installDir, stdio: 'pipe' }); } catch { /* ignore */ }
-    version = latestTag;
-  } else {
-    version = INSTALLER_VERSION || version;
-  }
-
-  const { project, org, language: lang = 'en', modules = [] } = cfg;
+  const { project, org, language: lang = 'en' } = cfg;
   const vars = { project, org };
 
   const managed = [...(cfg.files.managed || [])];
@@ -275,7 +230,7 @@ function syncTemplates(projectRoot) {
     templateVersion: version,
     templateRoot: norm(templateRoot),
     registryAdded: [],
-    managed: { written: [], created: [], unchanged: [], skippedMerged: [], skippedModule: [], removed: [] },
+    managed: { written: [], created: [], unchanged: [], skippedMerged: [], removed: [] },
     ejected: { created: [], skipped: [] },
     merged:  { pending: [] },
     configUpdated: false,
@@ -292,8 +247,6 @@ function syncTemplates(projectRoot) {
 
   const allRels = walkDir(templateRoot).map(f => norm(path.relative(templateRoot, f)));
   const allSet = new Set(allRels);
-  const modSet = new Set(modules);
-
   for (const entry of managed) {
     const isDir = entry.endsWith('/');
     let entryRels;
@@ -313,19 +266,11 @@ function syncTemplates(projectRoot) {
       if (!entryRels.length) continue;
     }
 
-    const selected = MULTI_LANG.has(norm(entry))
-      ? entryRels.map(r => [norm(renderPathname(r, project)), r])
-      : langSelect(entryRels, lang, allSet, project);
+    const selected = langSelect(entryRels, lang, allSet, project);
 
     for (const [tgt, src] of selected) {
       if (expectedTargets) expectedTargets.add(tgt);
 
-      const mod = fileModule(tgt);
-      if (mod !== null && !modSet.has(mod)) {
-        report.managed.skippedModule.push(tgt);
-        continue;
-      }
-
       if (matchesAny(tgt, merged) || matchesAny(tgt, ejected)) {
         report.managed.skippedMerged.push(tgt);
         continue;
@@ -364,11 +309,9 @@ function syncTemplates(projectRoot) {
         const projFiles = walkDir(projDir).map(f => norm(path.relative(projectRoot, f)));
         for (const projFile of projFiles) {
           if (expectedTargets.has(projFile)) continue;
+          if (projFile === configPathRel) continue;
           if (matchesAny(projFile, merged) || matchesAny(projFile, ejected)) continue;
 
-          const mod = fileModule(projFile);
-          if (mod !== null && !modSet.has(mod)) continue;
-
           fs.unlinkSync(path.join(projectRoot, projFile));
           report.managed.removed.push(projFile);
         }
@@ -420,9 +363,7 @@ function syncTemplates(projectRoot) {
       const ext = path.extname(entry), base = entry.slice(0, -ext.length);
       const zh = norm(base + '.zh-CN' + ext);
       if (allSet.has(zh)) rels.push(zh);
-      const selected = MULTI_LANG.has(n)
-        ? rels.map(r => [norm(renderPathname(r, project)), r])
-        : langSelect(rels, lang, allSet, project);
+      const selected = langSelect(rels, lang, allSet, project);
       for (const [t, s] of selected) {
         if (!mergedMap.has(t)) mergedMap.set(t, s);
       }
@@ -433,8 +374,7 @@ function syncTemplates(projectRoot) {
   );
 
   const projUrl = gitUrl(projectRoot);
-  const instUrl = gitUrl(installDir);
-  report.selfUpdate = !!(projUrl && instUrl && projUrl === instUrl);
+  report.selfUpdate = !!(projUrl && /fitlab-ai\/agent-infra/.test(projUrl));
 
   const hasChanges = (
     report.managed.written.length +
@@ -450,8 +390,9 @@ function syncTemplates(projectRoot) {
   cfg.files.merged  = merged;
   cfg.files.ejected = ejected;
   cfg.templateVersion = version;
+  delete cfg.templateSource;
 
-  report.configUpdated = hasChanges || prevVersion !== version;
+  report.configUpdated = hasChanges || prevVersion !== version || hadTemplateSource;
 
   fs.writeFileSync(cfgPath, JSON.stringify(cfg, null, 2) + '\n', 'utf8');
 

package/templates/.agents/skills/upgrade-dependency/SKILL.md

@@ -1,9 +1,6 @@
 ---
 name: upgrade-dependency
-description: >
-  Upgrade a specified dependency package to a new version and verify
-  the change. Triggered when the user requests dependency upgrade.
-  Arguments: package name, old version, new version.
+description: "Upgrade a dependency and validate the change"
 ---
 
 # Upgrade Dependency

package/templates/.agents/skills/upgrade-dependency/SKILL.zh-CN.md

@@ -1,8 +1,6 @@
 ---
 name: upgrade-dependency
-description: >
-  升级项目中的指定依赖包到新版本并验证变更。
-  当用户要求升级依赖时触发。参数：包名、原版本和新版本。
+description: "升级项目依赖到新版本并验证"
 ---
 
 # 升级依赖

package/templates/.agents/templates/handoff.md

@@ -55,6 +55,6 @@
 
 ## References
 
-- Task file: `.agent-workspace/active/task-XXX.md`
+- Task file: `.agents/workspace/active/task-XXX.md`
 - Related docs: [links or file paths]
 - Related issues: #XXX

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

@@ -55,6 +55,6 @@
 
 ## 参考资料
 
-- 任务文件：`.agent-workspace/active/task-XXX.md`
+- 任务文件：`.agents/workspace/active/task-XXX.md`
 - 相关文档：[链接或文件路径]
 - 相关 Issue：#XXX

package/templates/.agents/workflows/bug-fix.yaml

@@ -1,149 +1,149 @@
-# 缺陷修复工作流
-# 修复缺陷时使用此工作流。
+# Bug Fix Workflow
+# Use this workflow when fixing a bug.
 
 name: bug-fix
-description: 诊断和修复缺陷的工作流。
+description: Workflow for diagnosing and fixing a bug.
 
 steps:
   - name: analysis
-    description: 复现缺陷，识别根本原因，确定修复范围。
+    description: Reproduce the bug, identify the root cause, and determine the scope of the fix.
     recommended_agents:
       - claude
       - gemini
     tasks:
-      - 理解缺陷报告和预期行为
-      - 复现缺陷（如果可能）
-      - 追踪代码路径以识别根本原因
-      - 确定受影响的文件和组件
-      - 将发现记录在任务文件中
+      - Understand the bug report and expected behavior
+      - Reproduce the bug when possible
+      - Trace the code path to identify the root cause
+      - Determine impacted files and components
+      - Record findings in the task file
     inputs:
-      - 缺陷报告或 Issue 描述
-      - 复现步骤
-      - 项目代码库
+      - Bug report or issue description
+      - Reproduction steps
+      - Project codebase
     artifact_versioning:
       outputs:
         - name: analysis
           pattern: "analysis.md | analysis-r{N}.md"
-          rule: "扫描现有分析产物；首轮创建 analysis.md，后续修订创建 analysis-r{N}.md（N = 当前最高轮次 + 1）"
+          rule: "Scan existing analysis artifacts; create analysis.md for the first round, then analysis-r{N}.md for later revisions (N = current highest round + 1)"
     outputs:
-      - 根因分析
-      - 受影响文件列表
-      - 更新后的任务文件（分析部分）
+      - Root cause analysis
+      - List of impacted files
+      - Updated task file (analysis section)
 
   - name: design
-    description: 规划修复方案并考虑边界情况。
+    description: Plan the fix and consider edge cases.
     recommended_agents:
       - claude
     tasks:
-      - 确定修复缺陷的最佳方案
-      - 识别修复的潜在副作用
-      - 规划验证修复的测试用例
-      - 在任务文件中记录修复方案
+      - Determine the best approach for fixing the bug
+      - Identify potential side effects of the fix
+      - Plan test cases to validate the fix
+      - Record the fix plan in the task file
     inputs:
-      - 上一步的根因分析
-      - 项目架构
+      - Root cause analysis from the previous step
+      - Project architecture
     artifact_versioning:
       inputs:
         - name: analysis
           pattern: "analysis.md | analysis-r{N}.md"
-          rule: "读取最高轮次的分析产物作为设计输入"
+          rule: "Read the highest-round analysis artifact as design input"
       outputs:
         - name: plan
           pattern: "plan.md | plan-r{N}.md"
-          rule: "扫描现有方案产物；首轮创建 plan.md，后续修订创建 plan-r{N}.md（N = 当前最高轮次 + 1）"
+          rule: "Scan existing plan artifacts; create plan.md for the first round, then plan-r{N}.md for later revisions (N = current highest round + 1)"
     outputs:
-      - 任务文件中记录的修复方案
-      - 待添加的测试用例列表
+      - Fix plan recorded in the task file
+      - List of test cases to add
 
   - name: implementation
-    description: 实现缺陷修复并添加回归测试。
+    description: Implement the bug fix and add regression tests.
     recommended_agents:
       - codex
       - cursor
     tasks:
-      - 创建缺陷修复分支
-      - 实现修复
-      - 添加在没有修复时会失败的回归测试
-      - 验证现有测试仍然通过
-      - 确保代码遵循项目规范
+      - Create a bug-fix branch
+      - Implement the fix
+      - Add regression tests that would fail without the fix
+      - Verify that existing tests still pass
+      - Ensure the code follows project conventions
     inputs:
-      - 上一步的修复方案
-      - 项目编码标准
+      - Fix plan from the previous step
+      - Project coding standards
     artifact_versioning:
       outputs:
         - name: implementation
           pattern: "implementation.md | implementation-r{N}.md"
-          rule: "扫描现有实现产物；首轮创建 implementation.md，后续重实现创建 implementation-r{N}.md（N = 当前最高轮次 + 1）"
+          rule: "Scan existing implementation artifacts; create implementation.md for the first round, then implementation-r{N}.md for later re-implementations (N = current highest round + 1)"
     outputs:
-      - 包含实现的缺陷修复分支
-      - 回归测试文件
-      - 更新后的任务文件（实现备注）
+      - Bug-fix branch with the implementation
+      - Regression test files
+      - Updated task file (implementation notes)
 
   - name: review
-    description: 验证修复是否正确和完整。
+    description: Verify that the fix is correct and complete.
     recommended_agents:
       - claude
     tasks:
-      - 验证修复是否解决了根本原因
-      - 检查回归测试是否充分
-      - 确保未引入新问题
-      - 验证修复不会破坏现有功能
-      - 创建审查报告
+      - Verify that the fix addresses the root cause
+      - Check whether regression tests are sufficient
+      - Ensure no new issues were introduced
+      - Verify that the fix does not break existing functionality
+      - Create a review report
     inputs:
-      - 缺陷修复分支
-      - 根因分析
+      - Bug-fix branch
+      - Root cause analysis
     artifact_versioning:
       inputs:
         - name: implementation
           pattern: "implementation.md | implementation-r{N}.md"
-          rule: "读取最高轮次的实现产物作为审查输入"
+          rule: "Read the highest-round implementation artifact as review input"
       outputs:
         - name: review
           pattern: "review.md | review-r{N}.md"
-          rule: "扫描现有审查产物；首轮创建 review.md，后续轮次创建 review-r{N}.md（N = 当前最高轮次 + 1）"
+          rule: "Scan existing review artifacts; create review.md for the first round, then review-r{N}.md for later rounds (N = current highest round + 1)"
     outputs:
-      - 审查报告
-      - 问题列表（如有）
+      - Review report
+      - List of issues if any
 
   - name: fix
-    description: 处理审查中发现的问题。
+    description: Address issues found during review.
     recommended_agents:
       - codex
       - cursor
     tasks:
-      - 修复审查中识别的问题
-      - 根据需要更新测试
-      - 验证所有测试通过
+      - Fix issues identified in the review
+      - Update tests as needed
+      - Verify that all tests pass
     inputs:
-      - 审查报告
-      - 缺陷修复分支
+      - Review report
+      - Bug-fix branch
     artifact_versioning:
       inputs:
         - name: review
           pattern: "review.md | review-r{N}.md"
-          rule: "读取最高轮次的审查产物，并校验其与 task.md Activity Log 中最近一条 Code Review 记录一致"
+          rule: "Read the highest-round review artifact and verify that it matches the latest Code Review entry in the task.md Activity Log"
       outputs:
         - name: refinement
           pattern: "refinement.md | refinement-r{N}.md"
-          rule: "扫描现有修复产物；首轮创建 refinement.md，后续轮次创建 refinement-r{N}.md（N = 当前最高轮次 + 1）"
+          rule: "Scan existing refinement artifacts; create refinement.md for the first round, then refinement-r{N}.md for later rounds (N = current highest round + 1)"
     outputs:
-      - 包含修复的更新分支
-      - 更新后的任务文件
+      - Updated branch with fixes
+      - Updated task file
 
   - name: commit
-    description: 最终确认缺陷修复并创建拉取请求。
+    description: Finalize the bug fix and create a pull request.
     recommended_agents:
       - claude
       - human
     tasks:
-      - 确保所有测试通过
-      - 编写引用缺陷/Issue 的提交信息
-      - 创建包含缺陷修复描述的拉取请求
-      - 将 PR 关联到缺陷报告 Issue
-      - 将任务移至已完成
+      - Ensure all tests pass
+      - Write a commit message that references the bug or issue
+      - Create a pull request with a bug-fix summary
+      - Link the PR to the bug report issue
+      - Move the task to completed
     inputs:
-      - 最终缺陷修复分支
-      - 任务文件
+      - Final bug-fix branch
+      - Task file
     outputs:
-      - 拉取请求
-      - 已完成的任务文件（位于 .agent-workspace/completed/）
+      - Pull request
+      - Completed task file (stored in .agents/workspace/completed/)

package/templates/.agents/workflows/bug-fix.zh-CN.yaml

@@ -146,4 +146,4 @@ steps:
       - 任务文件
     outputs:
       - 拉取请求
-      - 已完成的任务文件（位于 .agent-workspace/completed/）
+      - 已完成的任务文件（位于 .agents/workspace/completed/）