@fitlab-ai/agent-infra 0.4.1 → 0.4.3

package/README.md

@@ -1,15 +1,25 @@
-# Agent Infra
+<p align="center">
+  <img src="./assets/logo.svg" alt="Agent Infra Logo" width="200">
+</p>
 
-[![npm version](https://img.shields.io/npm/v/@fitlab-ai/agent-infra)](https://www.npmjs.com/package/@fitlab-ai/agent-infra)
-[![npm downloads](https://img.shields.io/npm/dm/@fitlab-ai/agent-infra)](https://www.npmjs.com/package/@fitlab-ai/agent-infra)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](License.txt)
-[![Node.js >= 18](https://img.shields.io/badge/Node.js-%3E%3D18-brightgreen?logo=node.js)](https://nodejs.org/)
-[![GitHub release](https://img.shields.io/github/v/release/fitlab-ai/agent-infra)](https://github.com/fitlab-ai/agent-infra/releases)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+<h1 align="center">Agent Infra</h1>
 
-The missing collaboration layer for AI coding agents — unified skills and workflows for Claude Code, Codex, Gemini CLI, and OpenCode.
+<p align="center">
+  The missing collaboration layer for AI coding agents — unified skills and workflows for Claude Code, Codex, Gemini CLI, and OpenCode.
+</p>
 
-**Semi-automated programming, powered by AI agents.** Define a requirement, let AI handle analysis, planning, coding, review, and delivery — you only step in when it matters.
+<p align="center">
+  <strong>From issue to merged PR in 9 commands.</strong> Define a requirement, let AI handle analysis, planning, coding, review, and delivery — you only step in when it matters.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@fitlab-ai/agent-infra"><img src="https://img.shields.io/npm/v/@fitlab-ai/agent-infra" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@fitlab-ai/agent-infra"><img src="https://img.shields.io/npm/dm/@fitlab-ai/agent-infra" alt="npm downloads"></a>
+  <a href="License.txt"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
+  <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-%3E%3D18-brightgreen?logo=node.js" alt="Node.js >= 18"></a>
+  <a href="https://github.com/fitlab-ai/agent-infra/releases"><img src="https://img.shields.io/github/v/release/fitlab-ai/agent-infra" alt="GitHub release"></a>
+  <a href="CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome"></a>
+</p>
 
 [中文版](README.zh-CN.md)
 
@@ -74,7 +84,7 @@ Just fix it at the application layer in LoginService.
 
 ```bash
 /commit
-/create-pr
+/create-pr TASK-20260319-100000
 /complete-task TASK-20260319-100000
 ```
 
@@ -172,40 +182,30 @@ agent-infra is intentionally simple: a bootstrap CLI creates the seed configurat
 1. **Install** — `npm install -g @fitlab-ai/agent-infra` (or use the shell script wrapper)
 2. **Initialize** — `ai init` in the project root to generate `.agents/.airc.json` and install the seed command
 3. **Render** — run `update-agent-infra` in any AI TUI to detect the bundled template version and generate all managed files
-4. **Develop** — use 28 built-in skills to drive the full lifecycle: `analysis → design → implementation → review → fix → commit`
+4. **Develop** — use built-in skills to drive the full lifecycle: `analysis → design → implementation → review → fix → commit`
 5. **Update** — run `update-agent-infra` again whenever a new template version is available
 
 ### Layered Architecture
 
-```mermaid
-block-beta
-    columns 4
-
-    block:tui:4
-        columns 4
-        claude["Claude Code"] codex["Codex"] gemini["Gemini CLI"] opencode["OpenCode"]
-    end
-
-    space:4
-
-    block:shared:4
-        columns 3
-        skills["28 Skills"] workflows["4 Workflows"] templates["Templates"]
-    end
-
-    space:4
-
-    block:project:4
-        columns 4
-        agents[".agents/"] config[".agents/.airc.json"] workspace[".agents/workspace/"] governance["AGENTS.md"]
-    end
-
-    tui -- "slash commands" --> shared
-    shared -- "renders into" --> project
+```text
+┌───────────────────────────────────────────────────────┐
+│                     AI TUI Layer                      │
+│  Claude Code  ·  Codex  ·  Gemini CLI  ·  OpenCode    │
+└──────────────────────────┬────────────────────────────┘
+                           │ slash commands
+                           ▼
+┌───────────────────────────────────────────────────────┐
+│                     Shared Layer                      │
+│         Skills  ·  Workflows  ·  Templates            │
+└──────────────────────────┬────────────────────────────┘
+                           │ renders into
+                           ▼
+┌───────────────────────────────────────────────────────┐
+│                    Project Layer                      │
+│               .agents/  ·  AGENTS.md                  │
+└───────────────────────────────────────────────────────┘
 ```
 
-GitHub renders Mermaid diagrams natively. If a downstream renderer does not, the text above still explains the system structure.
-
 <a id="what-you-get"></a>
 
 ## What You Get
@@ -217,7 +217,7 @@ my-project/
 ├── .agents/               # Shared AI collaboration config
 │   ├── .airc.json         # Central configuration
 │   ├── workspace/         # Task workspace (git-ignored)
-│   ├── skills/            # 28 built-in AI skills
+│   ├── skills/            # Built-in AI skills
 │   ├── workflows/         # 4 prebuilt workflows
 │   └── templates/         # Task and artifact templates
 ├── .claude/               # Claude Code config and commands
@@ -230,7 +230,7 @@ my-project/
 
 ## Built-in AI Skills
 
-agent-infra ships with **28 built-in AI skills**. They are organized by use case, but they all share the same design goal: every AI TUI should be able to execute the same workflow vocabulary in the same repository.
+agent-infra ships with **a rich set of built-in AI skills**. They are organized by use case, but they all share the same design goal: every AI TUI should be able to execute the same workflow vocabulary in the same repository.
 
 <a id="task-lifecycle"></a>
 
@@ -255,6 +255,7 @@ agent-infra ships with **28 built-in AI skills**. They are organized by use case
 |-------|-------------|------------|----------------------|
 | `check-task` | Inspect the current task status, workflow progress, and next step. | `task-id` | Check progress without modifying task state. |
 | `block-task` | Move a task to blocked state and record the blocker reason. | `task-id`, `reason` (optional) | Pause work when an external dependency or decision is missing. |
+| `restore-task` | Restore local task files from GitHub Issue sync comments. | `issue-number`, `task-id` (optional) | Recover a task workspace after switching machines or clearing local state. |
 
 <a id="issue-and-pr"></a>
 
@@ -263,9 +264,7 @@ agent-infra ships with **28 built-in AI skills**. They are organized by use case
 | Skill | Description | Parameters | Recommended use case |
 |-------|-------------|------------|----------------------|
 | `create-issue` | Create a GitHub Issue from a task file. | `task-id` | Push a local task into GitHub tracking. |
-| `sync-issue` | Post task progress updates back to the linked GitHub Issue. | `task-id` or `issue-number` | Keep stakeholders updated as the task evolves. |
-| `create-pr` | Open a Pull Request to an inferred or explicit target branch. | `target-branch` (optional) | Publish reviewed changes for merge. |
-| `sync-pr` | Sync task progress and review metadata into the Pull Request. | `task-id` | Keep PR metadata aligned with the local task record. |
+| `create-pr` | Open a Pull Request to an inferred or explicit target branch. | `task-id` (optional), `target-branch` (optional) | Publish reviewed changes for merge, with optional explicit task linkage after a fresh session. |
 
 <a id="code-quality"></a>
 
@@ -307,6 +306,7 @@ agent-infra ships with **28 built-in AI skills**. They are organized by use case
 | `refine-title` | Rewrite an Issue or PR title into Conventional Commits format. | `number` | Normalize inconsistent GitHub titles. |
 | `init-labels` | Initialize the repository's standard GitHub label set. | None | Bootstrap labels in a new repository. |
 | `init-milestones` | Initialize the repository's milestone structure. | None | Bootstrap milestone tracking in a new repository. |
+| `archive-tasks` | Archive completed tasks into a date-organized directory with a manifest index. | `[--days N \| --before DATE \| TASK-ID...]` | Periodically clean up the `completed/` directory. |
 | `update-agent-infra` | Update the project's collaboration infrastructure to the latest template version. | None | Refresh shared AI tooling without rebuilding local conventions. |
 
 > Every skill works across supported AI TUIs. The command prefix changes, but the workflow semantics stay the same.
@@ -380,7 +380,7 @@ The generated `.agents/.airc.json` file is the central contract between the boot
   "project": "my-project",
   "org": "my-org",
   "language": "en",
-  "templateVersion": "v0.4.1",
+  "templateVersion": "v0.4.3",
   "files": {
     "managed": [
       ".agents/workspace/README.md",

package/README.zh-CN.md

@@ -1,15 +1,25 @@
-# Agent Infra
+<p align="center">
+  <img src="./assets/logo.svg" alt="Agent Infra 标志" width="200">
+</p>
 
-[![npm version](https://img.shields.io/npm/v/@fitlab-ai/agent-infra)](https://www.npmjs.com/package/@fitlab-ai/agent-infra)
-[![npm downloads](https://img.shields.io/npm/dm/@fitlab-ai/agent-infra)](https://www.npmjs.com/package/@fitlab-ai/agent-infra)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](License.txt)
-[![Node.js >= 18](https://img.shields.io/badge/Node.js-%3E%3D18-brightgreen?logo=node.js)](https://nodejs.org/)
-[![GitHub release](https://img.shields.io/github/v/release/fitlab-ai/agent-infra)](https://github.com/fitlab-ai/agent-infra/releases)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+<h1 align="center">Agent Infra</h1>
 
-AI 编程代理之间缺失的协作层 —— 为 Claude Code、Codex、Gemini CLI、OpenCode 提供统一的 skills 和工作流。
+<p align="center">
+  AI 编程代理之间缺失的协作层 —— 为 Claude Code、Codex、Gemini CLI、OpenCode 提供统一的 skills 和工作流。
+</p>
 
-**AI Agent 半自动化编程神器。** 定义需求，让 AI 完成分析、方案设计、编码、审查和交付 —— 你只需在关键节点介入。
+<p align="center">
+  <strong>从 Issue 到合并 PR，只需 9 条命令。</strong> 定义需求，让 AI 完成分析、方案设计、编码、审查和交付 —— 你只需在关键节点介入。
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@fitlab-ai/agent-infra"><img src="https://img.shields.io/npm/v/@fitlab-ai/agent-infra" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@fitlab-ai/agent-infra"><img src="https://img.shields.io/npm/dm/@fitlab-ai/agent-infra" alt="npm downloads"></a>
+  <a href="License.txt"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
+  <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-%3E%3D18-brightgreen?logo=node.js" alt="Node.js >= 18"></a>
+  <a href="https://github.com/fitlab-ai/agent-infra/releases"><img src="https://img.shields.io/github/v/release/fitlab-ai/agent-infra" alt="GitHub release"></a>
+  <a href="CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome"></a>
+</p>
 
 [English](README.md)
 
@@ -74,7 +84,7 @@ agent-infra 的目标就是把这层协作面标准化。它为所有支持的 A
 
 ```bash
 /commit
-/create-pr
+/create-pr TASK-20260319-100000
 /complete-task TASK-20260319-100000
 ```
 
@@ -172,40 +182,30 @@ agent-infra 的结构刻意保持简单：引导 CLI 负责生成种子配置，
 1. **安装** — `npm install -g @fitlab-ai/agent-infra`（或使用 shell 脚本便捷封装）
 2. **初始化** — 在项目根目录运行 `ai init`，生成 `.agents/.airc.json` 并安装种子命令
 3. **渲染** — 在任意 AI TUI 中执行 `update-agent-infra`，检测当前打包模板版本并生成所有受管理文件
-4. **开发** — 使用 28 个内置 skill 驱动完整生命周期：`analysis → design → implementation → review → fix → commit`
+4. **开发** — 使用内置 skill 驱动完整生命周期：`analysis → design → implementation → review → fix → commit`
 5. **升级** — 有新模板版本时再次执行 `update-agent-infra` 即可
 
 ### 分层架构
 
-```mermaid
-block-beta
-    columns 4
-
-    block:tui:4
-        columns 4
-        claude["Claude Code"] codex["Codex"] gemini["Gemini CLI"] opencode["OpenCode"]
-    end
-
-    space:4
-
-    block:shared:4
-        columns 3
-        skills["28 Skills"] workflows["4 Workflows"] templates["Templates"]
-    end
-
-    space:4
-
-    block:project:4
-        columns 4
-        agents[".agents/"] config[".agents/.airc.json"] workspace[".agents/workspace/"] governance["AGENTS.md"]
-    end
-
-    tui -- "slash commands" --> shared
-    shared -- "renders into" --> project
+```text
+┌───────────────────────────────────────────────────────┐
+│                     AI TUI Layer                      │
+│  Claude Code  ·  Codex  ·  Gemini CLI  ·  OpenCode    │
+└──────────────────────────┬────────────────────────────┘
+                           │ slash 命令
+                           ▼
+┌───────────────────────────────────────────────────────┐
+│                     Shared Layer                      │
+│         Skills  ·  Workflows  ·  Templates            │
+└──────────────────────────┬────────────────────────────┘
+                           │ 渲染为
+                           ▼
+┌───────────────────────────────────────────────────────┐
+│                    Project Layer                      │
+│               .agents/  ·  AGENTS.md                  │
+└───────────────────────────────────────────────────────┘
 ```
 
-GitHub 原生支持 Mermaid 渲染。即使某些下游渲染器不支持，上方文字也足以传达系统结构。
-
 <a id="what-you-get"></a>
 
 ## 安装效果
@@ -217,7 +217,7 @@ my-project/
 ├── .agents/               # 共享 AI 协作配置
 │   ├── .airc.json         # 中央配置文件
 │   ├── workspace/         # 任务工作区（git 忽略）
-│   ├── skills/            # 28 个内置 AI skills
+│   ├── skills/            # 内置 AI skills
 │   ├── workflows/         # 4 个预置工作流
 │   └── templates/         # 任务与产物模板
 ├── .claude/               # Claude Code 配置与命令
@@ -230,7 +230,7 @@ my-project/
 
 ## 内置 AI Skills
 
-agent-infra 内置 **28 个 AI skills**。它们按使用场景分组，但共享同一个核心目标：无论使用哪种 AI TUI，都能在同一仓库里执行相同的工作流词汇和协作约定。
+agent-infra 提供 **丰富的内置 AI skills**。它们按使用场景分组，但共享同一个核心目标：无论使用哪种 AI TUI，都能在同一仓库里执行相同的工作流词汇和协作约定。
 
 <a id="task-lifecycle"></a>
 
@@ -255,6 +255,7 @@ agent-infra 内置 **28 个 AI skills**。它们按使用场景分组，但共
 |-------|------|------|---------|
 | `check-task` | 查看当前任务状态、工作流进度和下一步建议。 | `task-id` | 不修改任务状态，仅检查当前进展。 |
 | `block-task` | 将任务标记为阻塞并记录阻塞原因。 | `task-id`、`reason`（可选） | 缺少外部依赖、决策或资源时暂停任务。 |
+| `restore-task` | 从 GitHub Issue 同步评论中还原本地任务文件。 | `issue-number`、`task-id`（可选） | 换机器或清空本地状态后恢复任务工作区。 |
 
 <a id="issue-and-pr"></a>
 
@@ -263,9 +264,7 @@ agent-infra 内置 **28 个 AI skills**。它们按使用场景分组，但共
 | Skill | 描述 | 参数 | 推荐场景 |
 |-------|------|------|---------|
 | `create-issue` | 根据任务文件创建 GitHub Issue。 | `task-id` | 需要把本地任务同步到 GitHub 跟踪时。 |
-| `sync-issue` | 将任务进度同步回关联的 GitHub Issue。 | `task-id` 或 `issue-number` | 任务推进过程中持续同步状态。 |
-| `create-pr` | 向推断出的目标分支或显式指定分支创建 Pull Request。 | `target-branch`（可选） | 变更准备合入时创建 PR。 |
-| `sync-pr` | 将任务进度和审查元数据同步到 Pull Request。 | `task-id` | 让 PR 元数据与本地任务记录保持一致。 |
+| `create-pr` | 向推断出的目标分支或显式指定分支创建 Pull Request。 | `task-id`（可选）、`target-branch`（可选） | 变更准备合入时创建 PR；清空上下文后也可显式传入任务关联。 |
 
 <a id="code-quality"></a>
 
@@ -307,6 +306,7 @@ agent-infra 内置 **28 个 AI skills**。它们按使用场景分组，但共
 | `refine-title` | 将 Issue 或 PR 标题重构为 Conventional Commits 格式。 | `number` | GitHub 标题格式不规范时。 |
 | `init-labels` | 初始化仓库标准 GitHub labels 体系。 | 无 | 新仓库首次配置 labels 时。 |
 | `init-milestones` | 初始化仓库 milestones 结构。 | 无 | 新仓库首次建立里程碑时。 |
+| `archive-tasks` | 将已完成任务按日期归档到目录中，并生成 `manifest` 索引。 | `[--days N \| --before DATE \| TASK-ID...]` | 需要定期清理 `completed/` 目录时。 |
 | `update-agent-infra` | 将项目协作基础设施升级到最新模板版本。 | 无 | 需要刷新共享 AI 工具层时。 |
 
 > 所有 skills 都可跨支持的 AI TUI 复用。变化的只是命令前缀，工作流语义保持一致。
@@ -380,7 +380,7 @@ import-issue #42                    从 GitHub Issue 导入任务
   "project": "my-project",
   "org": "my-org",
   "language": "en",
-  "templateVersion": "v0.4.1",
+  "templateVersion": "v0.4.3",
   "files": {
     "managed": [
       ".agents/workspace/README.md",

package/lib/defaults.json

@@ -1,7 +1,13 @@
 {
+  "labels": {
+    "in": {}
+  },
   "files": {
     "managed": [
+      ".agents/QUICKSTART.md",
+      ".agents/README.md",
       ".agents/skills/",
+      ".agents/scripts/",
       ".agents/templates/",
       ".agents/workflows/",
       ".agents/workspace/README.md",
@@ -16,22 +22,14 @@
       "**/test-integration.*",
       "**/test.*",
       "**/upgrade-dependency.*",
-      ".agents/QUICKSTART.md",
-      ".agents/README.md",
       ".agents/skills/release/SKILL.*",
       ".agents/skills/test-integration/SKILL.*",
       ".agents/skills/test/SKILL.*",
       ".agents/skills/upgrade-dependency/SKILL.*",
-      ".claude/CLAUDE.md",
-      ".claude/project-rules.md",
       ".claude/settings.json",
-      ".codex/README.md",
       ".gemini/settings.json",
       ".github/hooks/pre-commit",
-      ".gitignore",
-      ".opencode/COMMAND_STYLE_GUIDE.md",
-      ".opencode/README.md",
-      "AGENTS.md"
+      ".gitignore"
     ],
     "ejected": []
   }

package/lib/init.js

@@ -162,6 +162,7 @@ async function cmdInit() {
     org: orgName,
     language,
     templateVersion: VERSION,
+    labels: structuredClone(defaults.labels),
     files: structuredClone(defaults.files)
   };
 

package/lib/update.js

@@ -139,8 +139,15 @@ async function cmdUpdate() {
   // sync file registry
   const { added, changed } = syncFileRegistry(config);
   const hasNewEntries = added.managed.length > 0 || added.merged.length > 0;
+  const labelsAdded = !config.labels;
+  let configChanged = changed;
 
-  if (changed) {
+  if (labelsAdded) {
+    config.labels = structuredClone(defaults.labels);
+    configChanged = true;
+  }
+
+  if (configChanged) {
     console.log('');
     if (hasNewEntries) {
       info(`New file entries synced to ${CONFIG_PATH}:`);
@@ -150,9 +157,14 @@ async function cmdUpdate() {
       for (const entry of added.merged) {
         ok(`  merged: ${entry}`);
       }
+    } else if (labelsAdded) {
+      info(`Default labels.in config added to ${CONFIG_PATH}.`);
     } else {
       info(`File registry changed in ${CONFIG_PATH}.`);
     }
+    if (hasNewEntries && labelsAdded) {
+      info(`Default labels.in config added to ${CONFIG_PATH}.`);
+    }
     fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n', 'utf8');
     ok(`Updated ${CONFIG_PATH}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fitlab-ai/agent-infra",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Bootstrap tool for AI multi-tool collaboration infrastructure — works with Claude Code, Codex, Gemini CLI, and OpenCode",
   "license": "MIT",
   "type": "module",
@@ -43,7 +43,7 @@
   "scripts": {
     "build": "node scripts/build-inline.js",
     "prepare": "git config core.hooksPath .github/hooks || true",
-    "test": "node scripts/build-inline.js --check && node --test tests/*.test.js",
-    "prepublishOnly": "node scripts/build-inline.js --check && node --test tests/*.test.js"
+    "test": "node scripts/build-inline.js --check && node --test tests/cli/*.test.js tests/templates/*.test.js tests/core/*.test.js",
+    "prepublishOnly": "node scripts/build-inline.js --check && node --test tests/cli/*.test.js tests/templates/*.test.js tests/core/*.test.js"
   }
 }

package/templates/.agents/QUICKSTART.md

@@ -4,7 +4,7 @@ This guide walks you through using multiple AI coding assistants together on a p
 
 ## Prerequisites
 
-- At least one AI coding tool installed (Claude Code, Codex CLI, Gemini CLI, or Cursor)
+- At least one AI coding tool installed (Claude Code, Codex CLI, Gemini CLI, or OpenCode)
 - A project with `.agents/` directory set up (this project)
 - Familiarity with your project's codebase
 
@@ -32,7 +32,7 @@ cp .agents/templates/task.md .agents/workspace/active/task-001.md
 id: task-001
 type: feature          # feature | bugfix | refactor | docs | review
 status: open           # open | in-progress | review | blocked | completed
-assigned_to: claude    # claude | codex | gemini | cursor | human
+assigned_to: claude    # claude | codex | gemini | opencode | human
 ```
 
 3. Describe the task in the body of the document.
@@ -63,7 +63,7 @@ gemini
 #  create a technical design. Define interfaces and outline the approach."
 ```
 
-### Phase 3: Implementation (Recommended: Codex CLI or Cursor)
+### Phase 3: Implementation (Recommended: Codex CLI or OpenCode)
 
 ```bash
 # Switch to Codex CLI for implementation
@@ -91,7 +91,7 @@ claude
 ### Bug Fix
 
 1. **Reproduce & Analyze** (Claude Code): Identify the root cause.
-2. **Implement Fix** (Codex CLI / Cursor): Write the fix and tests.
+2. **Implement Fix** (Codex CLI / OpenCode): Write the fix and tests.
 3. **Review** (Claude Code): Verify the fix is correct and complete.
 4. **Commit**: Create PR with bug fix description.
 
@@ -100,7 +100,7 @@ claude
 cp .agents/templates/task.md .agents/workspace/active/bugfix-001.md
 # Edit the task, then:
 # 1. Use Claude Code to analyze
-# 2. Use Codex/Cursor to fix
+# 2. Use Codex/OpenCode to fix
 # 3. Use Claude Code to review
 ```
 
@@ -119,7 +119,7 @@ cp .agents/templates/review-report.md .agents/workspace/active/review-pr-42.md
 
 1. **Analyze Scope** (Claude Code / Gemini CLI): Map all affected areas.
 2. **Design** (Claude Code): Plan the refactoring approach.
-3. **Implement** (Codex CLI / Cursor): Execute the refactoring.
+3. **Implement** (Codex CLI / OpenCode): Execute the refactoring.
 4. **Verify** (Claude Code): Ensure no regressions, run tests.
 
 ```bash
@@ -156,7 +156,7 @@ Even if you're switching between AIs quickly, a brief handoff note saves time an
 ### 3. Use the Right Tool for the Job
 
 - Complex analysis? Use Claude Code or Gemini CLI.
-- Straightforward implementation? Use Codex CLI or Cursor.
+- Straightforward implementation? Use Codex CLI or OpenCode.
 - Large file review? Use Gemini CLI.
 
 ### 4. Keep Tasks Small

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

@@ -4,7 +4,7 @@
 
 ## 前提条件
 
-- 至少安装一个 AI 编程工具（Claude Code、Codex CLI、Gemini CLI 或 Cursor）
+- 至少安装一个 AI 编程工具（Claude Code、Codex CLI、Gemini CLI 或 OpenCode）
 - 项目已设置 `.agents/` 目录（本项目已就绪）
 - 熟悉你的项目代码库
 
@@ -23,7 +23,7 @@ git config core.hooksPath .github/hooks
 1. 将任务模板复制到活跃工作区：
 
 ```bash
-cp .agents/templates/task.zh-CN.md .agents/workspace/active/task-001.md
+cp .agents/templates/task.md .agents/workspace/active/task-001.md
 ```
 
 2. 填写任务元数据：
@@ -32,7 +32,7 @@ cp .agents/templates/task.zh-CN.md .agents/workspace/active/task-001.md
 id: task-001
 type: feature          # feature | bugfix | refactor | docs | review
 status: open           # open | in-progress | review | blocked | completed
-assigned_to: claude    # claude | codex | gemini | cursor | human
+assigned_to: claude    # claude | codex | gemini | opencode | human
 ```
 
 3. 在文档正文中描述任务。
@@ -63,7 +63,7 @@ gemini
 #  创建技术设计方案。定义接口并概述实现思路。"
 ```
 
-### 阶段 3：实现（推荐：Codex CLI 或 Cursor）
+### 阶段 3：实现（推荐：Codex CLI 或 OpenCode）
 
 ```bash
 # 切换到 Codex CLI 进行实现
@@ -91,16 +91,16 @@ claude
 ### 缺陷修复
 
 1. **复现和分析**（Claude Code）：识别根本原因。
-2. **实现修复**（Codex CLI / Cursor）：编写修复代码和测试。
+2. **实现修复**（Codex CLI / OpenCode）：编写修复代码和测试。
 3. **审查**（Claude Code）：验证修复是否正确和完整。
 4. **提交**：创建包含缺陷修复描述的 PR。
 
 ```bash
 # 快速缺陷修复工作流
-cp .agents/templates/task.zh-CN.md .agents/workspace/active/bugfix-001.md
+cp .agents/templates/task.md .agents/workspace/active/bugfix-001.md
 # 编辑任务，然后：
 # 1. 使用 Claude Code 分析
-# 2. 使用 Codex/Cursor 修复
+# 2. 使用 Codex/OpenCode 修复
 # 3. 使用 Claude Code 审查
 ```
 
@@ -111,7 +111,7 @@ cp .agents/templates/task.zh-CN.md .agents/workspace/active/bugfix-001.md
 3. **报告**：从模板生成审查报告。
 
 ```bash
-cp .agents/templates/review-report.zh-CN.md .agents/workspace/active/review-pr-42.md
+cp .agents/templates/review-report.md .agents/workspace/active/review-pr-42.md
 # 使用 Claude Code 填写审查内容
 ```
 
@@ -119,12 +119,12 @@ cp .agents/templates/review-report.zh-CN.md .agents/workspace/active/review-pr-4
 
 1. **分析范围**（Claude Code / Gemini CLI）：映射所有受影响区域。
 2. **设计**（Claude Code）：规划重构方案。
-3. **实现**（Codex CLI / Cursor）：执行重构。
+3. **实现**（Codex CLI / OpenCode）：执行重构。
 4. **验证**（Claude Code）：确保没有回归问题，运行测试。
 
 ```bash
-cp .agents/templates/task.zh-CN.md .agents/workspace/active/refactor-001.md
-# 按照 .agents/workflows/refactoring.zh-CN.yaml 中的重构工作流执行
+cp .agents/templates/task.md .agents/workspace/active/refactor-001.md
+# 按照 .agents/workflows/refactoring.yaml 中的重构工作流执行
 ```
 
 ## 创建交接文档
@@ -132,7 +132,7 @@ cp .agents/templates/task.zh-CN.md .agents/workspace/active/refactor-001.md
 在 AI 工具之间切换时，创建交接文档：
 
 ```bash
-cp .agents/templates/handoff.zh-CN.md .agents/workspace/active/handoff-task-001-phase2.md
+cp .agents/templates/handoff.md .agents/workspace/active/handoff-task-001-phase2.md
 ```
 
 填写：
@@ -156,7 +156,7 @@ cp .agents/templates/handoff.zh-CN.md .agents/workspace/active/handoff-task-001-
 ### 3. 选择合适的工具
 
 - 复杂分析？使用 Claude Code 或 Gemini CLI。
-- 直接的实现工作？使用 Codex CLI 或 Cursor。
+- 直接的实现工作？使用 Codex CLI 或 OpenCode。
 - 大文件审查？使用 Gemini CLI。
 
 ### 4. 保持任务小而精