@fitlab-ai/agent-infra 0.4.4 → 0.5.0

package/templates/.agents/rules/issue-sync.md

@@ -88,12 +88,16 @@ Use this format:
 <!-- sync-issue:{task-id}:{file-stem} -->
 ## {artifact-title}
 
+> **{agent}** · {task-id}
+
 {artifact body}
 
 ---
-*Generated by AI · Internal tracking: {task-id}*
+*Generated by {agent} · Internal tracking: {task-id}*
 ```
 
+`{agent}` is the name of the AI agent currently executing the skill (for example `claude`, `codex`, or `gemini`).
+
 `summary` comments need extra handling:
 - find an existing `<!-- sync-issue:{task-id}:summary -->` comment ID first
 - create the comment when none exists
@@ -133,6 +137,8 @@ task.md comment format:
 <!-- sync-issue:{task-id}:task -->
 ## Task File
 
+> **{agent}** · {task-id}
+
 <details><summary>Metadata (frontmatter)</summary>
 
 ​```yaml
@@ -146,7 +152,7 @@ task.md comment format:
 {task.md body after frontmatter}
 
 ---
-*Generated by AI · Internal tracking: {task-id}*
+*Generated by {agent} · Internal tracking: {task-id}*
 ```
 
 When restoring, extract the frontmatter from the `<details>` block and reassemble with the body to recover the original `task.md`.
@@ -159,6 +165,10 @@ Title mapping:
 - Scan `task.md`, `analysis*.md`, `plan*.md`, `implementation*.md`, `review*.md`, and `refinement*.md` in the task directory
 - Check whether each `{file-stem}` was already published by its hidden marker; publish only missing artifacts
 - Backfill only appends missing comments; never delete or reorder existing comments
+- Resolve `{agent}` for backfilled comments in this order:
+  1. Match the artifact filename in Activity Log (for example `→ analysis.md`) and extract the executor from `by {agent}`
+  2. If no match is found, fall back to `assigned_to` in task.md frontmatter
+  3. If `assigned_to` is also unavailable, use the current backfilling agent
 - Derive the previous and next neighbors from Activity Log order and add this note below the title:
 
 ```markdown

package/templates/.agents/rules/issue-sync.zh-CN.md

@@ -88,12 +88,16 @@ gh api "repos/{owner}/{repo}/issues/{issue-number}/comments" \
 <!-- sync-issue:{task-id}:{file-stem} -->
 ## {artifact-title}
 
+> **{agent}** · {task-id}
+
 {artifact body}
 
 ---
-*由 AI 自动生成 · 内部追踪：{task-id}*
+*由 {agent} 自动生成 · 内部追踪：{task-id}*
 ```
 
+其中 `{agent}` 使用当前执行该技能的 AI 代理名称（如 `claude`、`codex`、`gemini`）。
+
 `summary` 评论需要额外处理：
 - 先查找已有 `<!-- sync-issue:{task-id}:summary -->` 评论的 ID
 - 不存在则创建
@@ -133,6 +137,8 @@ task.md 评论格式：
 <!-- sync-issue:{task-id}:task -->
 ## 任务文件
 
+> **{agent}** · {task-id}
+
 <details><summary>元数据 (frontmatter)</summary>
 
 ​```yaml
@@ -146,7 +152,7 @@ task.md 评论格式：
 {task.md body after frontmatter}
 
 ---
-*由 AI 自动生成 · 内部追踪：{task-id}*
+*由 {agent} 自动生成 · 内部追踪：{task-id}*
 ```
 
 还原时，从 `<details>` 块中提取 frontmatter，与正文拼合恢复为原始 `task.md`。
@@ -159,6 +165,10 @@ task.md 评论格式：
 - 扫描任务目录中的 `task.md`、`analysis*.md`、`plan*.md`、`implementation*.md`、`review*.md`、`refinement*.md`
 - 对每个 `{file-stem}` 用隐藏标记检查是否已发布；未发布则补发，已发布则跳过
 - 补发只追加缺失评论，不删除或重排已有评论
+- 补发评论的 `{agent}` 按以下顺序确定：
+  1. 从 Activity Log 中匹配对应产物文件名（如 `→ analysis.md`），提取 `by {agent}` 中的执行者
+  2. 若未匹配到，则回退到 task.md frontmatter 的 `assigned_to`
+  3. 若 `assigned_to` 也不可用，则使用当前执行补发的 agent
 - 位置说明从 Activity Log 推导时间线中的前后邻居，并加在评论标题下方：
 
 ```markdown

package/templates/.agents/rules/task-management.md

@@ -0,0 +1,28 @@
+# General Rules - Task Management
+
+## Task Intent Detection
+
+Map user intent to the corresponding workflow command:
+- "analyze issue #123" -> `import-issue`
+- "analyze task TASK-20260306-143022" -> `analyze-task`
+- "design a plan" -> `plan-task`
+- "implement" or "build" -> `implement-task`
+- "review" -> `review-task`
+- "fix review feedback" -> `refine-task`
+
+## Task State Management
+
+- Update the corresponding `task.md` immediately after every workflow command
+- At minimum, synchronize `current_step`, `updated_at`, `assigned_to`, and the current-round artifact reference
+- Activity Log entries are append-only and must never overwrite history
+
+## Required State Updates by Command
+
+- `import-issue`: update `current_step`, `updated_at`, `assigned_to`
+- `analyze-task`: update `current_step`, `updated_at`, `assigned_to`
+- `plan-task`: update `current_step`, `updated_at`
+- `implement-task`: update `current_step`, `updated_at`
+- `review-task`: update `current_step`, `updated_at`
+- `refine-task`: update `current_step`, `updated_at`
+- `complete-task`: update `status`, `completed_at`, `updated_at`
+- `block-task`: update `status`, `blocked_at`, `blocked_reason`

package/templates/.agents/rules/task-management.zh-CN.md

@@ -0,0 +1,28 @@
+# 通用规则 - 任务管理
+
+## 任务语义识别
+
+根据用户意图自动映射到对应工作流命令：
+- “分析 issue #123” -> `import-issue`
+- “分析任务 TASK-20260306-143022” -> `analyze-task`
+- “设计方案” -> `plan-task`
+- “实施/实现” -> `implement-task`
+- “审查” -> `review-task`
+- “修复审查问题” -> `refine-task`
+
+## 任务状态管理
+
+- 每次执行工作流命令后，必须立即更新对应任务的 `task.md`
+- 至少同步 `current_step`、`updated_at`、`assigned_to`，以及本轮产物引用
+- Activity Log 只能追加，不能覆盖历史记录
+
+## 常见命令的状态更新要求
+
+- `import-issue`：更新 `current_step`、`updated_at`、`assigned_to`
+- `analyze-task`：更新 `current_step`、`updated_at`、`assigned_to`
+- `plan-task`：更新 `current_step`、`updated_at`
+- `implement-task`：更新 `current_step`、`updated_at`
+- `review-task`：更新 `current_step`、`updated_at`
+- `refine-task`：更新 `current_step`、`updated_at`
+- `complete-task`：更新 `status`、`completed_at`、`updated_at`
+- `block-task`：更新 `status`、`blocked_at`、`blocked_reason`

package/templates/.agents/scripts/validate-artifact.js

@@ -33,6 +33,7 @@ const DEFAULT_RETRY_DELAYS_MS = [3000, 10000];
 const DEFAULT_FRESHNESS_MINUTES = 30;
 const DATE_TIME_PATTERN = /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/;
 const ACTIVITY_LOG_PATTERN = /^- (\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}) — \*\*(.+?)\*\* by (.+?) — (.+)$/;
+const BRANCH_SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 
 const scriptPath = fileURLToPath(import.meta.url);
 const repoRoot = path.resolve(path.dirname(scriptPath), "..", "..");
@@ -190,6 +191,11 @@ function checkTaskMeta({ taskDir, config }) {
     }
   }
 
+  const branchValidationError = validateTaskBranch(metadata);
+  if (branchValidationError) {
+    return failResult("task-meta", branchValidationError);
+  }
+
   const expectedStep = config.expected_step;
   if (expectedStep && metadata.current_step !== expectedStep) {
     return failResult(
@@ -232,6 +238,40 @@ function checkTaskMeta({ taskDir, config }) {
   return passResult("task-meta", `Task metadata valid (${requiredFields.length} required fields checked)`);
 }
 
+function validateTaskBranch(metadata) {
+  if (isBlank(metadata.branch)) {
+    return null;
+  }
+
+  const projectName = loadProjectName();
+  const expectedPrefix = projectName ? `${projectName}-${metadata.type}-` : "";
+
+  if (expectedPrefix && !String(metadata.branch).startsWith(expectedPrefix)) {
+    return `Invalid branch: expected prefix '${expectedPrefix}', got '${metadata.branch}'`;
+  }
+
+  const slug = expectedPrefix ? String(metadata.branch).slice(expectedPrefix.length) : String(metadata.branch);
+  if (!BRANCH_SLUG_PATTERN.test(slug)) {
+    return `Invalid branch: '${metadata.branch}' must use kebab-case suffixes`;
+  }
+
+  return null;
+}
+
+function loadProjectName() {
+  const configPath = path.join(repoRoot, ".agents", ".airc.json");
+  if (!fs.existsSync(configPath)) {
+    return "";
+  }
+
+  try {
+    const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+    return String(config.project || "").trim();
+  } catch {
+    return "";
+  }
+}
+
 function checkArtifact({ taskDir, config, artifactFile }) {
   const resolvedArtifact = resolveArtifactPath(taskDir, config.file_pattern, artifactFile);
   if (!resolvedArtifact.ok) {

package/templates/.agents/skills/archive-tasks/SKILL.md

@@ -5,7 +5,10 @@ description: "Archive completed tasks into a date-organized workspace directory"
 
 # Archive Completed Tasks
 
-Move completed tasks from `.agents/workspace/completed/` into `.agents/workspace/archive/YYYY/MM/DD/TASK-xxx/` and rebuild the archive index `manifest.md`.
+Move completed tasks from `.agents/workspace/completed/` into `.agents/workspace/archive/YYYY/MM/DD/TASK-xxx/` and rebuild a three-level archive index:
+- root manifest: `.agents/workspace/archive/manifest.md`
+- yearly manifest: `.agents/workspace/archive/YYYY/manifest.md`
+- monthly manifest: `.agents/workspace/archive/YYYY/MM/manifest.md`
 
 ## Execution Flow
 
@@ -29,7 +32,7 @@ The script is responsible for:
 - reading `completed_at` from `task.md` frontmatter and falling back to `updated_at`
 - moving task directories directly into `YYYY/MM/DD/TASK-xxx/` without compression
 - skipping already archived, missing, or malformed tasks
-- rebuilding `.agents/workspace/archive/manifest.md` from all archived tasks
+- rebuilding root, yearly, and monthly manifests from all archived tasks
 - printing an archive and skip summary
 
 ### 3. Inform the user
@@ -37,4 +40,4 @@ The script is responsible for:
 Report:
 - how many tasks were archived
 - how many tasks were skipped and why
-- the path to `manifest.md`
+- the path to the root manifest

package/templates/.agents/skills/archive-tasks/SKILL.zh-CN.md

@@ -5,7 +5,10 @@ description: "归档已完成任务到按日期组织的目录"
 
 # 归档已完成任务
 
-将 `.agents/workspace/completed/` 中的已完成任务移动到 `.agents/workspace/archive/YYYY/MM/DD/TASK-xxx/`，并重建归档索引 `manifest.md`。
+将 `.agents/workspace/completed/` 中的已完成任务移动到 `.agents/workspace/archive/YYYY/MM/DD/TASK-xxx/`，并重建三级归档索引：
+- 根 manifest：`.agents/workspace/archive/manifest.md`
+- 年 manifest：`.agents/workspace/archive/YYYY/manifest.md`
+- 月 manifest：`.agents/workspace/archive/YYYY/MM/manifest.md`
 
 ## 执行流程
 
@@ -29,7 +32,7 @@ bash .agents/skills/archive-tasks/scripts/archive-tasks.sh [--days N | --before
 - 解析 `task.md` frontmatter 中的 `completed_at`（缺失时回退到 `updated_at`）
 - 按 `YYYY/MM/DD/TASK-xxx/` 目录直接移动任务，不压缩
 - 跳过已归档、缺少元数据或不存在的任务
-- 全量重建 `.agents/workspace/archive/manifest.md`
+- 全量重建根 / 年 / 月三级 manifest
 - 输出归档与跳过摘要
 
 ### 3. 告知用户
@@ -37,4 +40,4 @@ bash .agents/skills/archive-tasks/scripts/archive-tasks.sh [--days N | --before
 向用户汇报：
 - 本次归档的任务数量
 - 跳过的任务数量和原因
-- `manifest.md` 的路径
+- 根 manifest 的路径

package/templates/.agents/skills/archive-tasks/scripts/archive-tasks.sh

@@ -208,6 +208,8 @@ should_archive_filtered_task() {
 
 rebuild_manifest() {
   entries_file="$tmpdir/manifest.tsv"
+  month_keys_file="$tmpdir/manifest-months.tsv"
+  year_keys_file="$tmpdir/manifest-years.tsv"
   generated_at=$(date "+%Y-%m-%d %H:%M:%S")
 
   mkdir -p "$ARCHIVE_DIR"
@@ -253,26 +255,107 @@ rebuild_manifest() {
             fi
           fi
 
-          printf '%s\t%s\t%s\t%s\t%s\n' "$completed_at" "$task_id" "$title" "$task_type" "$relative_path" >> "$entries_file"
+          printf '%s\t%s\t%s\t%s\t%s\t%s\t%s\n' "$year" "$month" "$completed_at" "$task_id" "$title" "$task_type" "$relative_path" >> "$entries_file"
         done
       done
     done
   done
 
+  find "$ARCHIVE_DIR" -type f -name 'manifest.md' -exec rm -f {} \;
+
+  awk -F'\t' '{print $1 "\t" $2}' "$entries_file" | LC_ALL=C sort -u > "$month_keys_file"
+  awk -F'\t' '{print $1}' "$entries_file" | LC_ALL=C sort -u > "$year_keys_file"
+
+  while IFS="$(printf '\t')" read -r year month; do
+    [ -n "$year" ] || continue
+    [ -n "$month" ] || continue
+
+    month_entries_file="$tmpdir/manifest-${year}-${month}.tsv"
+    month_manifest_path="$ARCHIVE_DIR/$year/$month/manifest.md"
+
+    awk -F'\t' -v target_year="$year" -v target_month="$month" '
+      $1 == target_year && $2 == target_month {
+        print $3 "\t" $4 "\t" $5 "\t" $6 "\t" $7
+      }
+    ' "$entries_file" | LC_ALL=C sort -r > "$month_entries_file"
+
+    month_entry_count=$(wc -l < "$month_entries_file" | tr -d ' ')
+
+    {
+      echo "# Archive Manifest"
+      echo
+      echo "> Auto-generated by archive-tasks. Do not edit manually."
+      echo "> Last updated: $generated_at"
+      echo
+      echo "| Task ID | Title | Type | Completed | Path |"
+      echo "| --- | --- | --- | --- | --- |"
+
+      head -n 1000 "$month_entries_file" | while IFS="$(printf '\t')" read -r completed_at task_id title task_type relative_path; do
+        [ -n "$task_id" ] || continue
+        printf '| %s | %s | %s | %s | %s |\n' "$task_id" "$title" "$task_type" "$completed_at" "$relative_path"
+      done
+
+      if [ "$month_entry_count" -gt 1000 ]; then
+        echo
+        printf '> Showing 1000 of %s entries.\n' "$month_entry_count"
+      fi
+    } > "$month_manifest_path"
+  done < "$month_keys_file"
+
+  while IFS= read -r year; do
+    [ -n "$year" ] || continue
+
+    year_manifest_path="$ARCHIVE_DIR/$year/manifest.md"
+
+    {
+      echo "# Archive Manifest"
+      echo
+      echo "> Auto-generated by archive-tasks. Do not edit manually."
+      echo "> Last updated: $generated_at"
+      echo
+      echo "| Month | Tasks | Manifest |"
+      echo "| --- | --- | --- |"
+
+      awk -F'\t' -v target_year="$year" '
+        $1 == target_year {
+          counts[$2] += 1
+        }
+
+        END {
+          for (month in counts) {
+            print month "\t" counts[month]
+          }
+        }
+      ' "$entries_file" | LC_ALL=C sort -r | while IFS="$(printf '\t')" read -r month task_count; do
+        [ -n "$month" ] || continue
+        printf '| %s | %s | [%s/manifest.md](%s/manifest.md) |\n' "$month" "$task_count" "$month" "$month"
+      done
+    } > "$year_manifest_path"
+  done < "$year_keys_file"
+
   {
     echo "# Archive Manifest"
     echo
     echo "> Auto-generated by archive-tasks. Do not edit manually."
     echo "> Last updated: $generated_at"
     echo
-    echo "| Task ID | Title | Type | Completed | Path |"
-    echo "| --- | --- | --- | --- | --- |"
+    echo "| Year | Tasks | Manifest |"
+    echo "| --- | --- | --- |"
 
-    if [ -s "$entries_file" ]; then
-      LC_ALL=C sort -r "$entries_file" | while IFS="$(printf '\t')" read -r completed_at task_id title task_type relative_path; do
-        printf '| %s | %s | %s | %s | %s |\n' "$task_id" "$title" "$task_type" "$completed_at" "$relative_path"
-      done
-    fi
+    awk -F'\t' '
+      {
+        counts[$1] += 1
+      }
+
+      END {
+        for (year in counts) {
+          print year "\t" counts[year]
+        }
+      }
+    ' "$entries_file" | LC_ALL=C sort -r | while IFS="$(printf '\t')" read -r year task_count; do
+      [ -n "$year" ] || continue
+      printf '| %s | %s | [%s/manifest.md](%s/manifest.md) |\n' "$year" "$task_count" "$year" "$year"
+    done
   } > "$MANIFEST_PATH"
 }
 

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

@@ -27,6 +27,10 @@ Extract from the natural-language description:
 - **Task title**: a concise title (maximum 50 characters), in the same language as the user's description - do not translate it to English or apply Conventional Commits formatting
 - **Task type**: `feature` | `bugfix` | `refactor` | `docs` | `chore` (infer from the description)
 - **Workflow**: `feature-development` | `bug-fix` | `refactoring` (infer from the type)
+- **Branch name**: format `<project>-<type>-<slug>`
+  - `<project>` comes from the `project` field in `.agents/.airc.json`
+  - `<type>` is the inferred task type
+  - `<slug>` is a kebab-case slug built from 3-6 English keywords extracted from the task title
 - **Detailed description**: the cleaned-up original user request
 
 If the description is unclear, **ask the user to clarify first**.
@@ -64,6 +68,7 @@ Task metadata (`task.md` YAML front matter):
 ```yaml
 id: TASK-{yyyyMMdd-HHmmss}
 type: feature|bugfix|refactor|docs|chore
+branch: <project>-<type>-<slug>
 workflow: feature-development|bug-fix|refactoring
 status: active
 created_at: {yyyy-MM-dd HH:mm:ss}
@@ -87,6 +92,7 @@ Update `.agents/workspace/active/{task-id}/task.md`:
 - `current_step`: requirement-analysis
 - `assigned_to`: {current AI agent}
 - `updated_at`: {current time}
+- `## Context` -> `- **Branch**:`: update it to the generated branch name
 - **Append** to `## Activity Log` (do NOT overwrite previous entries):
   ```
   - {yyyy-MM-dd HH:mm:ss} — **Task Created** by {agent} — Task created from description

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

@@ -27,6 +27,10 @@ description: "根据自然语言描述创建任务"
 - **任务标题**：简洁标题（最多 50 个字符），使用中文——不要翻译为英文，不要套用 Conventional Commits 格式
 - **任务类型**：`feature` | `bugfix` | `refactor` | `docs` | `chore`（从描述推断）
 - **工作流**：`feature-development` | `bug-fix` | `refactoring`（从类型推断）
+- **分支名**：格式 `<project>-<type>-<slug>`
+  - `<project>` 从 `.agents/.airc.json` 的 `project` 字段读取
+  - `<type>` 为推断出的任务类型
+  - `<slug>` 从任务标题提取 3-6 个英文关键词并转为 kebab-case
 - **详细描述**：整理后的用户原始描述
 
 如果描述不清晰，**先向用户确认**再继续。
@@ -64,6 +68,7 @@ date +%Y%m%d-%H%M%S
 ```yaml
 id: TASK-{yyyyMMdd-HHmmss}
 type: feature|bugfix|refactor|docs|chore
+branch: <project>-<type>-<slug>
 workflow: feature-development|bug-fix|refactoring
 status: active
 created_at: {yyyy-MM-dd HH:mm:ss}
@@ -87,6 +92,7 @@ date "+%Y-%m-%d %H:%M:%S"
 - `current_step`：requirement-analysis
 - `assigned_to`：{当前 AI 代理}
 - `updated_at`：{当前时间}
+- `## 上下文` 中的 `- **分支**：`：更新为生成的分支名
 - **追加**到 `## Activity Log`（不要覆盖之前的记录）：
   ```
   - {yyyy-MM-dd HH:mm:ss} — **Task Created** by {agent} — Task created from description

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

@@ -5,6 +5,7 @@
       "required_fields": [
         "id",
         "type",
+        "branch",
         "workflow",
         "status",
         "created_at",

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

@@ -44,6 +44,7 @@ Task metadata:
 id: TASK-{yyyyMMdd-HHmmss}
 issue_number: <issue-number>
 type: feature|bugfix|refactor|docs|chore
+branch: <project>-<type>-<slug>
 workflow: feature-development|bug-fix|refactoring
 status: active
 created_at: {yyyy-MM-dd HH:mm:ss}
@@ -65,6 +66,7 @@ Update `.agents/workspace/active/{task-id}/task.md`:
 - `current_step`: requirement-analysis
 - `assigned_to`: {current AI agent}
 - `updated_at`: {current time}
+- `## Context` -> `- **Branch**:`: update it to the generated branch name
 - **Append** to `## Activity Log` (do NOT overwrite previous entries):
   ```
   - {yyyy-MM-dd HH:mm:ss} — **Import Issue** by {agent} — Issue #{number} imported

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

@@ -44,6 +44,7 @@ date +%Y%m%d-%H%M%S
 id: TASK-{yyyyMMdd-HHmmss}
 issue_number: <issue-number>
 type: feature|bugfix|refactor|docs|chore
+branch: <project>-<type>-<slug>
 workflow: feature-development|bug-fix|refactoring
 status: active
 created_at: {yyyy-MM-dd HH:mm:ss}
@@ -65,6 +66,7 @@ date "+%Y-%m-%d %H:%M:%S"
 - `current_step`：requirement-analysis
 - `assigned_to`：{当前 AI 代理}
 - `updated_at`：{当前时间}
+- `## 上下文` 中的 `- **分支**：`：更新为生成的分支名
 - **追加**到 `## Activity Log`（不要覆盖之前的记录）：
   ```
   - {yyyy-MM-dd HH:mm:ss} — **Import Issue** by {agent} — Issue #{number} imported

package/templates/.agents/skills/import-issue/config/verify.json

@@ -5,6 +5,7 @@
       "required_fields": [
         "id",
         "type",
+        "branch",
         "workflow",
         "status",
         "created_at",

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

@@ -20,6 +20,23 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const DEFAULTS = {
+  "sandbox": {
+    "runtimes": [
+      "node20"
+    ],
+    "tools": [
+      "claude-code",
+      "codex",
+      "opencode",
+      "gemini-cli"
+    ],
+    "dockerfile": null,
+    "vm": {
+      "cpu": null,
+      "memory": null,
+      "disk": null
+    }
+  },
   "labels": {
     "in": {}
   },
@@ -57,7 +74,7 @@ const DEFAULTS = {
   }
 };
 
-const INSTALLER_VERSION = "v0.4.4";
+const INSTALLER_VERSION = "v0.5.0";
 
 function norm(p) { return p.replace(/\\/g, '/'); }
 

package/templates/.agents/templates/task.md

@@ -1,12 +1,13 @@
 ---
 id: task-XXX
-type: feature          # feature | bugfix | refactor | docs | review
+type: feature                  # feature | bugfix | refactor | docs | review
+branch: ""                     # <project>-<type>-<slug>
 workflow: feature-development  # feature-development | bug-fix | code-review | refactoring
-status: open           # open | in-progress | review | blocked | completed
+status: open                   # open | in-progress | review | blocked | completed
 created_at: YYYY-MM-DD
 updated_at: YYYY-MM-DD
-current_step: analysis # analysis | design | implementation | review | fix | commit
-assigned_to: ""        # claude | codex | gemini | opencode | human
+current_step: analysis         # analysis | design | implementation | review | fix | commit
+assigned_to: ""                # claude | codex | gemini | opencode | human
 ---
 
 # Task: [Title]

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

@@ -1,12 +1,13 @@
 ---
 id: task-XXX
-type: feature          # feature | bugfix | refactor | docs | review
+type: feature                  # feature | bugfix | refactor | docs | review
+branch: ""                     # <project>-<type>-<slug>
 workflow: feature-development  # feature-development | bug-fix | code-review | refactoring
-status: open           # open | in-progress | review | blocked | completed
+status: open                   # open | in-progress | review | blocked | completed
 created_at: YYYY-MM-DD
 updated_at: YYYY-MM-DD
-current_step: analysis # analysis | design | implementation | review | fix | commit
-assigned_to: ""        # claude | codex | gemini | opencode | human
+current_step: analysis         # analysis | design | implementation | review | fix | commit
+assigned_to: ""                # claude | codex | gemini | opencode | human
 ---
 
 # 任务：[标题]