@fitlab-ai/agent-infra 0.9.2 → 0.9.3

package/lib/task/verification.ts

@@ -17,6 +17,7 @@ type VerificationEvent =
   | 'create-pr.completed' | 'create-task.completed'
   | 'import-codescan.completed' | 'import-dependabot.completed'
   | 'import-issue.completed' | 'watch-pr.completed'
+  | 'review-pr.completed'
   | 'run-task.paused' | 'run-task.completed';
 type VerificationSpec = {
   skill: string;
@@ -64,7 +65,7 @@ const VERIFICATION_CATALOG: Readonly<Record<VerificationEvent, VerificationSpec>
   'block-task.completed': gate('block-task', 'blocked'),
   'cancel-task.completed': gate('cancel-task', 'completed'),
   'commit.completed': gate('commit', 'active'),
-  'complete-task.preflight': { skill: 'complete-task', expectedState: 'active', mode: 'checks', checks: ['review-ledger', 'post-review-commit', 'platform-sync-preflight'] },
+  'complete-task.preflight': { skill: 'complete-task', expectedState: 'active', mode: 'checks', checks: ['review-ledger', 'manual-validation', 'post-review-commit', 'platform-sync-preflight'] },
   'complete-task.completed': gate('complete-task', 'completed'),
   'create-pr.completed': gate('create-pr', 'active'),
   'create-task.completed': gate('create-task', 'active'),
@@ -72,8 +73,9 @@ const VERIFICATION_CATALOG: Readonly<Record<VerificationEvent, VerificationSpec>
   'import-dependabot.completed': gate('import-dependabot', 'active'),
   'import-issue.completed': gate('import-issue', 'active'),
   'watch-pr.completed': gate('watch-pr', 'active'),
-  'run-task.paused': { skill: 'run-task', expectedState: 'active', mode: 'checks', checks: ['orchestration-state'] },
-  'run-task.completed': { skill: 'run-task', expectedState: 'active', mode: 'checks', checks: ['orchestration-state'] }
+  'review-pr.completed': gate('review-pr', 'active', 'pr-review'),
+  'run-task.paused': { skill: 'run-task', expectedState: 'active', mode: 'checks', checks: ['orchestration-state', 'orchestration-evidence'] },
+  'run-task.completed': { skill: 'run-task', expectedState: 'active', mode: 'checks', checks: ['orchestration-state', 'orchestration-evidence'] }
 };
 
 function failure(request: { taskRef: string; event: string; artifact?: string }, code: string, message: string, extra: Partial<TaskVerificationResult> = {}): TaskVerificationResult {

package/lib/task/workspace-snapshot.ts

@@ -12,15 +12,20 @@ function git(repoRoot: string, indexFile: string | null, args: string[]): string
   return result.stdout;
 }
 
-function captureWorkspaceSnapshot(repoRoot: string): string {
+type RepositorySnapshot = Readonly<{
+  head: string;
+  headTree: string;
+  worktreeTree: string;
+}>;
+
+function captureWorktreeTree(repoRoot: string, forcedPath: string | null): string {
   const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-infra-orchestration-index-'));
   const indexFile = path.join(tempDir, 'index');
   try {
     git(repoRoot, indexFile, ['read-tree', 'HEAD']);
     git(repoRoot, indexFile, ['add', '-A', '--', ':/']);
-    const workspace = path.join(repoRoot, '.agents', 'workspace', 'active');
-    if (fs.existsSync(workspace)) {
-      git(repoRoot, indexFile, ['add', '-f', '--', '.agents/workspace/active']);
+    if (forcedPath && fs.existsSync(path.join(repoRoot, forcedPath))) {
+      git(repoRoot, indexFile, ['add', '-f', '--', forcedPath]);
     }
     return git(repoRoot, indexFile, ['write-tree']).trim();
   } finally {
@@ -28,9 +33,25 @@ function captureWorkspaceSnapshot(repoRoot: string): string {
   }
 }
 
+function captureWorkspaceSnapshot(repoRoot: string, taskId: string | null): string {
+  const workspaceRelative = taskId
+    ? `.agents/workspace/active/${taskId}`
+    : '.agents/workspace/active';
+  return captureWorktreeTree(repoRoot, workspaceRelative);
+}
+
+function captureRepositorySnapshot(repoRoot: string): RepositorySnapshot {
+  return {
+    head: git(repoRoot, null, ['rev-parse', 'HEAD']).trim(),
+    headTree: git(repoRoot, null, ['rev-parse', 'HEAD^{tree}']).trim(),
+    worktreeTree: captureWorktreeTree(repoRoot, null)
+  };
+}
+
 function diffWorkspaceSnapshots(repoRoot: string, before: string, after: string): string[] {
   const output = git(repoRoot, null, ['diff', '--name-only', '-z', before, after]);
   return output.split('\0').filter(Boolean);
 }
 
-export { captureWorkspaceSnapshot, diffWorkspaceSnapshots };
+export { captureRepositorySnapshot, captureWorkspaceSnapshot, diffWorkspaceSnapshots };
+export type { RepositorySnapshot };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fitlab-ai/agent-infra",
-  "version": "0.9.2",
-  "description": "Bootstrap tool for AI multi-tool collaboration infrastructure — works with Claude Code, Codex, Gemini CLI, and OpenCode",
+  "version": "0.9.3",
+  "description": "Bootstrap tool for AI multi-tool collaboration infrastructure — works with Claude Code, Codex, Antigravity CLI, and OpenCode",
   "license": "MIT",
   "type": "module",
   "author": "CodeCaster <codecaster365@outlook.com>",
@@ -38,7 +38,7 @@
     "collaboration",
     "claude-code",
     "codex",
-    "gemini",
+    "antigravity",
     "opencode",
     "cli",
     "bootstrap",

package/templates/.agents/QUICKSTART.en.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 OpenCode)
+- At least one AI coding tool installed (Claude Code, Codex CLI, Antigravity CLI, or OpenCode)
 - A project with `.agents/` directory set up (this project)
 - Familiarity with your project's codebase
 
@@ -18,6 +18,23 @@ git config core.hooksPath .git-hooks
 
 This makes Git invoke the hooks in the project repository's `.git-hooks/` directory, including `pre-commit` and `check-version-format.sh`.
 
+## Development Checkout CLI Alignment
+
+When developing agent-infra from a source checkout, install dependencies and rebuild the local CLI before running lifecycle orchestration:
+
+```bash
+npm install
+npm run build
+```
+
+Lifecycle hooks prefer the checkout's `dist/bin/internal-cli.js` when it exists and fall back to `agent-infra-internal` on `PATH` otherwise. Rebuild after CLI source changes. If shell commands must also resolve to this checkout, link it and compare the active version with the package version:
+
+```bash
+npm link
+ai version --raw
+node -p "'v' + require('./package.json').version"
+```
+
 ## External Templates And Skills
 
 If your team maintains private platform templates or shared custom skills, configure local sources in `.agents/.airc.json`:
@@ -49,7 +66,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 | opencode | human
+assigned_to: claude    # claude | codex | antigravity | opencode | human
 ```
 
 3. Describe the task in the body of the document.
@@ -69,11 +86,11 @@ claude
 
 Claude Code excels at codebase exploration and understanding complex relationships between files.
 
-### Phase 2: Design (Recommended: Claude Code or Gemini CLI)
+### Phase 2: Design (Recommended: Claude Code or Antigravity CLI)
 
 ```bash
-# Continue with Claude Code or switch to Gemini CLI for large codebases
-gemini
+# Continue with Claude Code or switch to Antigravity CLI for large codebases
+agy
 
 # Example prompt:
 # "Based on the analysis in .agents/workspace/active/task-001.md,
@@ -134,7 +151,7 @@ cp .agents/templates/review-report.md .agents/workspace/active/review-pr-42.md
 
 ### Refactoring
 
-1. **Analyze Scope** (Claude Code / Gemini CLI): Map all affected areas.
+1. **Analyze Scope** (Claude Code / Antigravity CLI): Map all affected areas.
 2. **Design** (Claude Code): Plan the refactoring approach.
 3. **Implement** (Codex CLI / OpenCode): Execute the refactoring.
 4. **Verify** (Claude Code): Ensure no regressions, run tests.
@@ -172,9 +189,9 @@ 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.
+- Complex analysis? Use Claude Code or Antigravity CLI.
 - Straightforward implementation? Use Codex CLI or OpenCode.
-- Large file review? Use Gemini CLI.
+- Large file review? Use Antigravity CLI.
 
 ### 4. Keep Tasks Small
 

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

@@ -4,7 +4,7 @@
 
 ## 前提条件
 
-- 至少安装一个 AI 编程工具（Claude Code、Codex CLI、Gemini CLI 或 OpenCode）
+- 至少安装一个 AI 编程工具（Claude Code、Codex CLI、Antigravity CLI 或 OpenCode）
 - 项目已设置 `.agents/` 目录（本项目已就绪）
 - 熟悉你的项目代码库
 
@@ -18,6 +18,23 @@ git config core.hooksPath .git-hooks
 
 这样 Git 才会调用项目仓库 `.git-hooks/` 目录下的 hook，包括 `pre-commit` 和 `check-version-format.sh`。
 
+## 开发检出中的 CLI 对齐
+
+从源码检出开发 agent-infra 时，请先安装依赖并重新构建本地 CLI，再运行生命周期编排：
+
+```bash
+npm install
+npm run build
+```
+
+本地 `dist/bin/internal-cli.js` 存在时，生命周期 hook 会优先使用它；不存在时则回退到 `PATH` 上的 `agent-infra-internal`。修改 CLI 源码后需要重新构建。如果 shell 命令也必须解析到当前检出，请建立链接并比较当前版本与包版本：
+
+```bash
+npm link
+ai version --raw
+node -p "'v' + require('./package.json').version"
+```
+
 ## 外部模板与 Skill
 
 如果团队维护私有平台模板或共享自定义 skill，可在 `.agents/.airc.json` 中配置本地源：
@@ -49,7 +66,7 @@ cp .agents/templates/task.md .agents/workspace/active/task-001.md
 id: task-001
 type: feature          # feature | bugfix | refactor | docs | chore
 status: active         # active | blocked | completed
-assigned_to: claude    # claude | codex | gemini | opencode | human
+assigned_to: claude    # claude | codex | antigravity | opencode | human
 ```
 
 3. 在文档正文中描述任务。
@@ -69,11 +86,11 @@ claude
 
 Claude Code 擅长代码库探索和理解文件间的复杂关系。
 
-### 阶段 2：设计（推荐：Claude Code 或 Gemini CLI）
+### 阶段 2：设计（推荐：Claude Code 或 Antigravity CLI）
 
 ```bash
-# 继续使用 Claude Code 或切换到 Gemini CLI 处理大型代码库
-gemini
+# 继续使用 Claude Code 或切换到 Antigravity CLI 处理大型代码库
+agy
 
 # 示例提示：
 # "基于 .agents/workspace/active/task-001.md 中的分析结果，
@@ -134,7 +151,7 @@ cp .agents/templates/review-report.md .agents/workspace/active/review-pr-42.md
 
 ### 重构
 
-1. **分析范围**（Claude Code / Gemini CLI）：映射所有受影响区域。
+1. **分析范围**（Claude Code / Antigravity CLI）：映射所有受影响区域。
 2. **设计**（Claude Code）：规划重构方案。
 3. **实现**（Codex CLI / OpenCode）：执行重构。
 4. **验证**（Claude Code）：确保没有回归问题，运行测试。
@@ -172,9 +189,9 @@ cp .agents/templates/handoff.md .agents/workspace/active/handoff-task-001-phase2
 
 ### 3. 选择合适的工具
 
-- 复杂分析？使用 Claude Code 或 Gemini CLI。
+- 复杂分析？使用 Claude Code 或 Antigravity CLI。
 - 直接的实现工作？使用 Codex CLI 或 OpenCode。
-- 大文件审查？使用 Gemini CLI。
+- 大文件审查？使用 Antigravity CLI。
 
 ### 4. 保持任务小而精
 

package/templates/.agents/README.en.md

@@ -1,6 +1,6 @@
 # Multi-AI Collaboration Guide
 
-This project supports collaboration across multiple AI coding assistants, including Claude Code, OpenAI Codex CLI, Gemini CLI, OpenCode, and others.
+This project supports collaboration across multiple AI coding assistants, including Claude Code, OpenAI Codex CLI, Antigravity CLI, OpenCode, and others.
 
 ## Dual-Config Architecture
 
@@ -10,7 +10,7 @@ Different AI tools read configuration from different locations:
 |---------|---------------|----------|
 | Claude Code | `.claude/` (CLAUDE.md, commands/, settings.json) | - |
 | OpenAI Codex CLI | `AGENTS.md` | - |
-| Gemini CLI | `AGENTS.md` | - |
+| Antigravity CLI | `AGENTS.md`, `.agents/skills/` | - |
 | OpenCode | `AGENTS.md` | - |
 | Other AI Tools | `AGENTS.md` | Project README |
 
@@ -75,7 +75,7 @@ When one AI completes a phase, it produces a **handoff document** (see `.agents/
 
 Each AI tool has different strengths. Use them accordingly:
 
-| Capability | Claude Code | Codex CLI | Gemini CLI | OpenCode |
+| Capability | Claude Code | Codex CLI | Antigravity CLI | OpenCode |
 |-----------|-------------|-----------|------------|----------|
 | Codebase analysis | Excellent | Good | Excellent | Good |
 | Code review | Excellent | Good | Good | Good |
@@ -88,7 +88,7 @@ Each AI tool has different strengths. Use them accordingly:
 
 - **Analysis & Review** - Claude Code (strong reasoning, thorough exploration)
 - **Implementation** - Codex CLI or OpenCode (fast code generation, command-driven editing)
-- **Large Context Tasks** - Gemini CLI (large context window for cross-file analysis)
+- **Large Context Tasks** - Antigravity CLI (large context window for cross-file analysis)
 - **Command-Driven Iteration** - OpenCode (workflow-friendly TUI execution)
 
 ## Quick Start
@@ -173,7 +173,7 @@ Write `description` as "one-line responsibility + scenario clause": after the sh
 
 Set the generic optional `disable-model-invocation` field to `true` when generated TUI commands should disable model invocation; each TUI adapter consumes it according to its capabilities. To preserve line breaks in a multiline `description`, use a YAML literal block (`|`); sync emits the corresponding multiline metadata format for each TUI.
 
-After adding or updating a custom skill, run `update-agent-infra` again. The sync step detects non-built-in skills and generates matching commands for Claude Code, Gemini CLI, and OpenCode automatically.
+After adding or updating a custom skill, run `update-agent-infra` again. The sync step detects non-built-in skills, generates matching commands for Claude Code and OpenCode, and lets Antigravity CLI discover the shared skills directly.
 
 ### Shared skill sources
 
@@ -220,13 +220,16 @@ Ordinary `managed` files keep their overwrite semantics. A small set of platform
 
 ## Agent Client Configuration
 
-Use the top-level `.agents/.airc.json` `agentClients` array to configure all four built-in clients (`claude-code`, `codex`, `gemini-cli`, `opencode`). Each canonical entry has three fields:
+Use the top-level `.agents/.airc.json` `agentClients` array to configure all four built-in clients (`claude-code`, `codex`, `antigravity-cli`, `opencode`). Each canonical entry has three required fields and one optional orchestration policy:
 
 | Field | Meaning |
 |-------|---------|
 | `id` | Built-in Agent Client id. The canonical array contains exactly one entry for each built-in client. |
 | `enabled` | Whether agent-infra writes and maintains that client's project integration and seed command. |
 | `installInSandbox` | Whether the sandbox image installs that client's CLI. This is independent from `enabled`. |
+| `orchestration` | Optional `run-task` default. It must include executor/reviewer `model` and host-native `reasoningEffort`; both roles may use the same model. |
+
+Explicit `run-task` model/effort flags are atomic: any one requires all four role fields and configuration never fills omissions. With no explicit policy, only the current client's `orchestration` is used. Query model-selection context with `agent-infra-internal agent-client model-selection --client <id>`; it labels results complete, partial, or interactive-only and never presents a local override list as a complete catalog.
 
 Manage these settings without hand-editing JSON:
 
@@ -234,7 +237,7 @@ Manage these settings without hand-editing JSON:
 ai agent-client list
 ai agent-client status
 ai agent-client enable codex
-ai agent-client disable gemini-cli
+ai agent-client disable antigravity-cli
 ai agent-client configure
 ```
 

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

@@ -1,6 +1,6 @@
 # 多 AI 协作指南
 
-本项目支持多个 AI 编程助手协同工作，包括 Claude Code、OpenAI Codex CLI、Gemini CLI、OpenCode 等。
+本项目支持多个 AI 编程助手协同工作，包括 Claude Code、OpenAI Codex CLI、Antigravity CLI、OpenCode 等。
 
 ## 双配置架构
 
@@ -10,7 +10,7 @@
 |---------|---------|---------|
 | Claude Code | `.claude/`（CLAUDE.md、commands/、settings.json） | - |
 | OpenAI Codex CLI | `AGENTS.md` | - |
-| Gemini CLI | `AGENTS.md` | - |
+| Antigravity CLI | `AGENTS.md`、`.agents/skills/` | - |
 | OpenCode | `AGENTS.md` | - |
 | 其他 AI 工具 | `AGENTS.md` | 项目 README |
 
@@ -75,7 +75,7 @@
 
 每个 AI 工具有不同的优势，请据此分配任务：
 
-| 能力 | Claude Code | Codex CLI | Gemini CLI | OpenCode |
+| 能力 | Claude Code | Codex CLI | Antigravity CLI | OpenCode |
 |-----|-------------|-----------|------------|----------|
 | 代码库分析 | 优秀 | 良好 | 优秀 | 良好 |
 | 代码审查 | 优秀 | 良好 | 良好 | 良好 |
@@ -88,7 +88,7 @@
 
 - **分析和审查** - Claude Code（推理能力强，探索全面）
 - **代码实现** - Codex CLI 或 OpenCode（代码生成快，命令式工作流顺手）
-- **大上下文任务** - Gemini CLI（大上下文窗口，适合跨文件分析）
+- **大上下文任务** - Antigravity CLI（大上下文窗口，适合跨文件分析）
 - **命令式迭代** - OpenCode（适合按工作流连续推进）
 
 ## 快速入门
@@ -173,7 +173,7 @@ disable-model-invocation: true   # 可选；由支持该能力的 TUI 适配器
 
 当生成的 TUI 命令需要禁用模型调用时，将通用可选字段 `disable-model-invocation` 设为 `true`；各 TUI 适配器按自身能力决定是否消费。多行 `description` 如需保留换行，使用 YAML literal block（`|`）；同步器会为各 TUI 输出对应的多行元数据格式。
 
-新增或修改自定义 skill 后，再执行一次 `update-agent-infra`。同步过程会自动检测非内置 skill，并为 Claude Code、Gemini CLI、OpenCode 生成对应命令。
+新增或修改自定义 skill 后，再执行一次 `update-agent-infra`。同步过程会自动检测非内置 skill，为 Claude Code 和 OpenCode 生成对应命令；Antigravity CLI 则直接发现共享 skill。
 
 ### 共享 skill 源
 
@@ -220,13 +220,16 @@ disable-model-invocation: true   # 可选；由支持该能力的 TUI 适配器
 
 ## Agent Client 配置
 
-`.agents/.airc.json` 顶层 `agentClients` 数组用于配置全部四个内建客户端（`claude-code`、`codex`、`gemini-cli`、`opencode`）。规范化后的每个条目包含三个字段：
+`.agents/.airc.json` 顶层 `agentClients` 数组用于配置全部四个内建客户端（`claude-code`、`codex`、`antigravity-cli`、`opencode`）。每个规范条目包含三个必填字段和一个可选编排策略：
 
 | 字段 | 含义 |
 |------|------|
 | `id` | 内建 Agent Client id。规范数组为每个内建客户端保留且仅保留一个条目。 |
 | `enabled` | agent-infra 是否写入并维护该客户端的项目集成与种子命令。 |
 | `installInSandbox` | 沙箱镜像是否安装该客户端 CLI；此字段与 `enabled` 相互独立。 |
+| `orchestration` | `run-task` 可选默认策略；必须同时提供 executor/reviewer 的 `model` 与宿主原生 `reasoningEffort`，两个角色可以使用同一模型。 |
+
+`run-task` 的显式 model/effort 参数是原子输入：只要提供其中任一字段，就必须完整提供四个 role 字段，不能从配置补齐。完全没有显式策略时，只读取当前客户端的 `orchestration`。模型目录通过 `agent-infra-internal agent-client model-selection --client <id>` 查询，并明确标记 complete、partial 或 interactive-only；局部 override 列表不能当作完整目录。
 
 无需手工编辑 JSON，可使用：
 
@@ -234,7 +237,7 @@ disable-model-invocation: true   # 可选；由支持该能力的 TUI 适配器
 ai agent-client list
 ai agent-client status
 ai agent-client enable codex
-ai agent-client disable gemini-cli
+ai agent-client disable antigravity-cli
 ai agent-client configure
 ```
 

package/templates/.agents/hooks/lifecycle-delegation.js

@@ -1,6 +1,9 @@
 import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
 
 const MAX_INPUT_BYTES = 64 * 1024;
+const localInternalCli = fileURLToPath(new URL('../../dist/bin/internal-cli.js', import.meta.url));
 const clientIndex = process.argv.indexOf('--client');
 const client = clientIndex >= 0 ? process.argv[clientIndex + 1] : '';
 if (client !== 'claude-code') {
@@ -39,10 +42,15 @@ process.stdin.on('end', () => {
       '--native-agent', String(nativeAgent),
       '--child-id', String(event.child_id || event.agent_id || event.thread_id || ''),
       '--parent-id', String(event.parent_id || event.parent_session_id || event.session_id || ''),
-      '--spawn-mode', String(event.spawn_mode || 'fresh')
+      '--spawn-mode', String(event.spawn_mode || (client === 'claude-code' ? 'fresh' : ''))
     );
     if (event.model) args.push('--actual-model', String(event.model));
-    if (event.model_fallback_reason) args.push('--fallback-reason', String(event.model_fallback_reason));
+    const actualEffort = event.actual_reasoning_effort || event.reasoning_effort || event.model_reasoning_effort;
+    if (actualEffort) args.push('--actual-reasoning-effort', String(actualEffort));
+    if (event.model_fallback_reason) args.push('--model-fallback-reason', String(event.model_fallback_reason));
+    if (event.reasoning_effort_fallback_reason) {
+      args.push('--reasoning-effort-fallback-reason', String(event.reasoning_effort_fallback_reason));
+    }
   } else {
     args.push(
       '--native-agent', String(nativeAgent),
@@ -50,9 +58,12 @@ process.stdin.on('end', () => {
     );
   }
   try {
-    const output = execFileSync('agent-infra-internal', args, {
+    const useLocal = existsSync(localInternalCli);
+    const command = useLocal ? process.execPath : 'agent-infra-internal';
+    const commandArgs = useLocal ? [localInternalCli, ...args] : args;
+    const output = execFileSync(command, commandArgs, {
       encoding: 'utf8',
-      shell: process.platform === 'win32',
+      shell: !useLocal && process.platform === 'win32',
       stdio: ['ignore', 'pipe', 'pipe']
     });
     process.stdout.write(output);

package/templates/.agents/rules/create-issue.github.en.md

@@ -1,10 +1,12 @@
 # Issue Creation
 
+> `--agent` values follow the "Collaborator Token Specification" in `.agents/rules/task-management.md`: standard AI short tokens (`claude`/`codex`/`antigravity`/`opencode`/`cursor`), long-name normalization (`claude-code`->`claude`, `antigravity-cli`->`antigravity`), or the `human` manual exception.
+
 After `create-task` writes task.md, create and initialize the Issue through declarative internal intents:
 
 ```bash
-agent-infra-internal platform-issue create {task-id} --agent {agent}
-agent-infra-internal platform-issue sync {task-id} --agent {agent} --status waiting-for-triage --assignees current --milestone initial --issue-type --fields
+agent-infra-internal platform-issue create {task-id} --agent {standard-agent-token}
+agent-infra-internal platform-issue sync {task-id} --agent {standard-agent-token} --status waiting-for-triage --assignees current --milestone initial --issue-type --fields
 ```
 
 The core reads only persisted task identity, title, type, description, and requirements, and reuses deterministic `ai task issue-body` rendering. It owns template selection, upstream/capabilities, duplicate prevention, POST outcome boundaries, response validation, and atomic `issue_number` binding.

package/templates/.agents/rules/create-issue.github.zh-CN.md

@@ -1,9 +1,11 @@
 # Issue 创建
 
+> `--agent` 取值见 `.agents/rules/task-management.md`「合作者 token 规范」：标准 AI 短名（`claude`/`codex`/`antigravity`/`opencode`/`cursor`）、长名归一化（`claude-code`→`claude`、`antigravity-cli`→`antigravity`）或人工例外 `human`。
+
 当 `create-task` 完成本地 `task.md` 落盘后，通过声明式内部命令创建 Issue：
 
 ```bash
-agent-infra-internal platform-issue create {task-id} --agent {agent}
+agent-infra-internal platform-issue create {task-id} --agent {standard-agent-token}
 ```
 
 命令只从已落盘 task.md 读取身份、标题、类型、描述与需求，并复用 `ai task issue-body` 的确定性正文渲染。它负责模板选择、upstream/capability、已有绑定检查、非幂等 POST 边界、响应身份校验及通过任务写入内核回写 `issue_number`。
@@ -11,7 +13,7 @@ agent-infra-internal platform-issue create {task-id} --agent {agent}
 创建后的初始元数据使用同一适配层同步：
 
 ```bash
-agent-infra-internal platform-issue sync {task-id} --agent {agent} \
+agent-infra-internal platform-issue sync {task-id} --agent {standard-agent-token} \
   --status waiting-for-triage --assignees current --milestone initial --issue-type --fields
 ```
 

package/templates/.agents/rules/issue-fields.github.en.md

@@ -1,9 +1,11 @@
 # Issue Fields
 
+> `--agent` values follow the "Collaborator Token Specification" in `.agents/rules/task-management.md`: standard AI short tokens (`claude`/`codex`/`antigravity`/`opencode`/`cursor`), long-name normalization (`claude-code`->`claude`, `antigravity-cli`->`antigravity`), or the `human` manual exception.
+
 Synchronize Issue Type and pinned fields through one intent:
 
 ```bash
-agent-infra-internal platform-issue sync {task-id} --agent {agent} --issue-type --fields
+agent-infra-internal platform-issue sync {task-id} --agent {standard-agent-token} --issue-type --fields
 ```
 
 Supported task.md mappings are `priority` → `Priority`, `effort` → `Effort`, `start_date` → `Start date`, and `target_date` → `Target date`. The core normalizes localized priority/effort options and validates `YYYY-MM-DD` dates.

package/templates/.agents/rules/issue-fields.github.zh-CN.md

@@ -1,9 +1,11 @@
 # Issue 字段
 
+> `--agent` 取值见 `.agents/rules/task-management.md`「合作者 token 规范」：标准 AI 短名（`claude`/`codex`/`antigravity`/`opencode`/`cursor`）、长名归一化（`claude-code`→`claude`、`antigravity-cli`→`antigravity`）或人工例外 `human`。
+
 Issue Type 与 pinned fields 统一由 `platform-issue` intent 动态读取组织 schema 并同步：
 
 ```bash
-agent-infra-internal platform-issue sync {task-id} --agent {agent} --issue-type --fields
+agent-infra-internal platform-issue sync {task-id} --agent {standard-agent-token} --issue-type --fields
 ```
 
 ## 支持字段

package/templates/.agents/rules/issue-pr-commands.en.md

@@ -1,5 +1,7 @@
 # PR Platform Intents
 
+> `--agent` values follow the "Collaborator Token Specification" in `.agents/rules/task-management.md`: standard AI short tokens (`claude`/`codex`/`antigravity`/`opencode`/`cursor`), long-name normalization (`claude-code`->`claude`, `antigravity-cli`->`antigravity`), or the `human` manual exception.
+
 PR lookup, creation, binding, and metadata synchronization go through typed internal intents. Skills decide branches and write titles/bodies; they do not assemble platform commands.
 
 ## Inspect
@@ -14,7 +16,7 @@ Write the title and body to files, then run:
 
 ```bash
 agent-infra-internal platform-pr create {task-id} \
-  --agent {agent} --base {target-branch} --head {current-branch} \
+  --agent {standard-agent-token} --base {target-branch} --head {current-branch} \
   --title-file {title-file} --body-file {body-file}
 ```
 
@@ -23,7 +25,7 @@ The core performs exact upstream/head/base lookup first. One match is reused, ze
 ## Bind
 
 ```bash
-agent-infra-internal platform-pr bind {task-id} --pr {pr-number} --agent {agent}
+agent-infra-internal platform-pr bind {task-id} --pr {pr-number} --agent {standard-agent-token}
 ```
 
 Conflicting bindings fail without changing `task.md`.
@@ -32,7 +34,7 @@ Conflicting bindings fail without changing `task.md`.
 
 ```bash
 agent-infra-internal platform-pr sync {task-id} \
-  --agent {agent} --metadata --closing-issue
+  --agent {standard-agent-token} --metadata --closing-issue
 ```
 
 The core copies type / `in:` labels, assignee, a specific milestone, and the closing association from the linked Issue. Permission-bound operations report `skipped` under top-level `degraded`; the Issue is never updated in reverse.

package/templates/.agents/rules/issue-pr-commands.github.en.md

@@ -1,5 +1,7 @@
 # PR Platform Intents
 
+> `--agent` values follow the "Collaborator Token Specification" in `.agents/rules/task-management.md`: standard AI short tokens (`claude`/`codex`/`antigravity`/`opencode`/`cursor`), long-name normalization (`claude-code`->`claude`, `antigravity-cli`->`antigravity`), or the `human` manual exception.
+
 PR lookup, creation, binding, and metadata synchronization go through typed internal intents. Skills decide branches and write titles/bodies; they do not assemble platform commands.
 
 ## Inspect
@@ -12,7 +14,7 @@ agent-infra-internal platform-pr inspect {task-id}
 
 ```bash
 agent-infra-internal platform-pr create {task-id} \
-  --agent {agent} --base {target-branch} --head {current-branch} \
+  --agent {standard-agent-token} --base {target-branch} --head {current-branch} \
   --title-file {title-file} --body-file {body-file}
 ```
 
@@ -21,10 +23,10 @@ The core performs exact upstream/head/base lookup. One match is reused, zero cre
 ## Bind and synchronize
 
 ```bash
-agent-infra-internal platform-pr bind {task-id} --pr {pr-number} --agent {agent}
+agent-infra-internal platform-pr bind {task-id} --pr {pr-number} --agent {standard-agent-token}
 
 agent-infra-internal platform-pr sync {task-id} \
-  --agent {agent} --metadata --closing-issue
+  --agent {standard-agent-token} --metadata --closing-issue
 ```
 
 Conflicting bindings do not change `task.md`. Metadata comes from the linked Issue, permission-bound items degrade independently, and an already-created PR is never rolled back.

package/templates/.agents/rules/issue-pr-commands.github.zh-CN.md

@@ -1,5 +1,7 @@
 # PR 平台意图命令
 
+> `--agent` 取值见 `.agents/rules/task-management.md`「合作者 token 规范」：标准 AI 短名（`claude`/`codex`/`antigravity`/`opencode`/`cursor`）、长名归一化（`claude-code`→`claude`、`antigravity-cli`→`antigravity`）或人工例外 `human`。
+
 PR 资源的定位、创建、绑定和元数据同步统一通过 typed internal intent；SKILL 只负责决定分支、标题、正文和调用时机，不直接拼装平台命令。
 
 ## 定位
@@ -16,7 +18,7 @@ agent-infra-internal platform-pr inspect {task-id}
 
 ```bash
 agent-infra-internal platform-pr create {task-id} \
-  --agent {agent} --base {target-branch} --head {current-branch} \
+  --agent {standard-agent-token} --base {target-branch} --head {current-branch} \
   --title-file {title-file} --body-file {body-file}
 ```
 
@@ -25,7 +27,7 @@ core 会先按 upstream、head 和 base 精确定位；唯一既有 PR 会复用
 ## 显式绑定
 
 ```bash
-agent-infra-internal platform-pr bind {task-id} --pr {pr-number} --agent {agent}
+agent-infra-internal platform-pr bind {task-id} --pr {pr-number} --agent {standard-agent-token}
 ```
 
 冲突绑定稳定失败且不修改 `task.md`。
@@ -34,7 +36,7 @@ agent-infra-internal platform-pr bind {task-id} --pr {pr-number} --agent {agent}
 
 ```bash
 agent-infra-internal platform-pr sync {task-id} \
-  --agent {agent} --metadata --closing-issue
+  --agent {standard-agent-token} --metadata --closing-issue
 ```
 
 core 从关联 Issue 复制 type / `in:` labels、assignee、具体 milestone，并确保 closing association。权限不足返回逐项 `skipped` 和顶层 `degraded`；不得反向修改 Issue。

package/templates/.agents/rules/issue-pr-commands.zh-CN.md

@@ -1,5 +1,7 @@
 # PR 平台意图命令
 
+> `--agent` 取值见 `.agents/rules/task-management.md`「合作者 token 规范」：标准 AI 短名（`claude`/`codex`/`antigravity`/`opencode`/`cursor`）、长名归一化（`claude-code`→`claude`、`antigravity-cli`→`antigravity`）或人工例外 `human`。
+
 PR 资源的定位、创建、绑定和元数据同步统一通过 typed internal intent；SKILL 只负责决定分支、标题、正文和调用时机，不直接拼装平台命令。
 
 ## 定位
@@ -16,7 +18,7 @@ agent-infra-internal platform-pr inspect {task-id}
 
 ```bash
 agent-infra-internal platform-pr create {task-id} \
-  --agent {agent} --base {target-branch} --head {current-branch} \
+  --agent {standard-agent-token} --base {target-branch} --head {current-branch} \
   --title-file {title-file} --body-file {body-file}
 ```
 
@@ -25,7 +27,7 @@ core 会先按 upstream、head 和 base 精确定位；唯一既有 PR 会复用
 ## 显式绑定
 
 ```bash
-agent-infra-internal platform-pr bind {task-id} --pr {pr-number} --agent {agent}
+agent-infra-internal platform-pr bind {task-id} --pr {pr-number} --agent {standard-agent-token}
 ```
 
 冲突绑定稳定失败且不修改 `task.md`。
@@ -34,7 +36,7 @@ agent-infra-internal platform-pr bind {task-id} --pr {pr-number} --agent {agent}
 
 ```bash
 agent-infra-internal platform-pr sync {task-id} \
-  --agent {agent} --metadata --closing-issue
+  --agent {standard-agent-token} --metadata --closing-issue
 ```
 
 core 从关联 Issue 复制 type / `in:` labels、assignee、具体 milestone，并确保 closing association。权限不足返回逐项 `skipped` 和顶层 `degraded`；不得反向修改 Issue。