@fitlab-ai/agent-infra 0.4.5 → 0.5.0

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.5";
+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
 ---
 
 # 任务：[标题]