@fitlab-ai/agent-infra 0.3.1 → 0.4.0

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

@@ -20,7 +20,7 @@ description: >
 ### 1. 验证前置条件
 
 检查必要文件：
-- `.agent-workspace/active/{task-id}/task.md` - 任务文件
+- `.agents/workspace/active/{task-id}/task.md` - 任务文件
 
 检查 GitHub CLI 可用且已认证：
 
@@ -62,15 +62,18 @@ Issue 内容规则：
 rg --files .github/ISSUE_TEMPLATE -g '*.yml' -g '!config.yml'
 ```
 
-如果存在模板文件，按任务类型优先在模板文件名或顶层 `name:` 字段中搜索以下关键词：
+如果存在模板文件，读取每个模板的顶层 `name:` 字段，构建候选列表。结合任务标题和描述，从候选列表中选择最匹配的模板。
 
-| task.md type | 匹配关键词 |
-|---|---|
-| `bug`、`bugfix` | `bug` |
-| `feature` | `feature` |
-| `enhancement` | `feature`、`enhancement` |
-| `docs`、`documentation` | `documentation`、`doc` |
-| 其他 | `other` |
+示例候选列表：
+- `bug_report.yml` — Bug 类模板
+- `question.yml` — 问题咨询类模板
+- `feature_request.yml` — 功能请求类模板
+- `documentation.yml` — 文档问题类模板
+- `other.yml` — 通用兜底模板
+
+如果没有明确匹配的模板，选择最接近的一个。
+
+以上文件名仅为示例，应以目标项目实际存在的模板为准。
 
 如果没有模板、没有匹配到合适模板，或模板 YAML 解析失败，则直接进入 **3c fallback / 兜底路径**。
 
@@ -172,16 +175,55 @@ issue_number="${issue_url##*/}"
 
 如果已经确定了 `{issue-type}`，在创建后以 best-effort 方式设置 Issue Type：
 
+先获取仓库信息，后续 `in:` label 步骤也会复用：
+
 ```bash
 repo="$(gh repo view --json nameWithOwner --jq '.nameWithOwner')"
 owner="${repo%%/*}"
+```
+
+查询组织可用的 Issue Types：
+
+```bash
 gh api "orgs/$owner/issue-types" --jq '.[].name'
-gh api "repos/$repo/issues/{issue-number}" -X PATCH -f type="{issue-type}"
 ```
 
+如果查询成功且 `{issue-type}` 在返回列表中，执行设置：
+
+```bash
+gh api "repos/$repo/issues/{issue-number}" -X PATCH -f type="{issue-type}" --silent
+```
+
+验证设置结果：
+
+```bash
+gh api "repos/$repo/issues/{issue-number}" --jq '.type.name // empty'
+```
+
+如果验证返回的名称与 `{issue-type}` 一致，记录 `Issue Type: {issue-type}`；否则记录 `Issue Type: failed to set`。
+
+#### 添加 `in:` labels
+
+获取仓库中所有 `in:` 前缀的 labels：
+
+```bash
+gh label list --search "in:" --limit 50 --json name --jq '.[].name'
+```
+
+如果没有 `in:` labels，跳过此步骤。
+
+如果存在 `in:` labels，结合任务上下文（标题、描述、受影响文件列表）判断每个 `in:` label 是否与当前任务相关。对判断为相关的 label，执行：
+
+```bash
+gh issue edit {issue-number} --add-label "in: {module}"
+```
+
+记录所有成功添加的 `in:` labels。如果没有判断为相关的 label，记录 `in: labels: skipped (no relevant labels)`。
+
 容错要求：
 - 如果 `orgs/$owner/issue-types` 返回 `404`、仓库 owner 不是组织，或仓库未启用 Issue Types，则跳过，不要让创建失败
 - 如果目标 `{issue-type}` 不在可用列表中，则跳过
+- `in:` label 添加失败时，跳过并记录，不阻止 Issue 创建流程
 - Milestone 不存在或名称无效时，也应提示并跳过，而不是中断整个 Issue 创建流程
 
 ### 5. 更新任务状态
@@ -192,7 +234,7 @@ gh api "repos/$repo/issues/{issue-number}" -X PATCH -f type="{issue-type}"
 date "+%Y-%m-%d %H:%M:%S"
 ```
 
-更新 `.agent-workspace/active/{task-id}/task.md`：
+更新 `.agents/workspace/active/{task-id}/task.md`：
 - 添加或更新 `issue_number`：`{issue-number}`
 - `updated_at`：{当前时间}
 - **追加**到 `## Activity Log`（不要覆盖之前的记录）：
@@ -212,7 +254,8 @@ Issue 信息：
 - 编号：#{issue-number}
 - URL：{issue-url}
 - Labels：{applied-labels 或 skipped}
-- Issue Type：{issue-type 或 skipped}
+- in: Labels：{applied-in-labels 或 skipped}
+- Issue Type：{issue-type | failed to set | skipped}
 - Milestone：{milestone 或 skipped}
 
 产出：
@@ -231,6 +274,7 @@ Issue 信息：
 - [ ] 有模板时按模板结构生成正文；无模板时走 fallback / 兜底格式
 - [ ] Issue 标题和正文仅来自 task.md
 - [ ] 如可用，处理了 `type:` / Issue Type 和 `milestone`
+- [ ] 处理了 `in:` labels（LLM 判断关联性）
 - [ ] 在 task.md 中记录了 `issue_number`
 - [ ] 更新了 task.md 中的 `updated_at`
 - [ ] 追加了 Activity Log 条目到 task.md
@@ -248,6 +292,7 @@ Issue 信息：
 3. **Label 容错**：标准 label 未初始化时，可以跳过 label，但不要阻止 Issue 创建
 4. **模板容错**：模板缺失、匹配失败或 YAML 异常时，退回 fallback / 兜底正文，不要让整个创建失败
 5. **Issue Type / Milestone 容错**：Issue Type 未启用、类型不存在或 milestone 不可用时，跳过该项并继续创建
+6. **in: Label 容错**：`in:` label 添加失败时跳过，不阻止 Issue 创建
 
 ## 错误处理
 

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

@@ -64,13 +64,22 @@ git push -u origin <current-branch>
 
 ### 7. Create PR
 
+- If this work is associated with an active task, extract `issue_number` from task.md
+- If `issue_number` exists, query Issue information on a best-effort basis and skip on failure:
+  ```bash
+  gh issue view {issue-number} --json number,title --jq '.number' 2>/dev/null
+  ```
 - Follow `.github/PULL_REQUEST_TEMPLATE.md` format for all sections
 - Reference recent merged PRs for style
 - Use HEREDOC format to pass the body
+- If `issue_number` exists:
+  - replace `{$IssueNumber}` in the template with the actual Issue number
+  - use `Closes #{issue_number}` in the `Related Issue` section
+- If `issue_number` does not exist, keep the current behavior
 - PR must end with: `Generated with AI assistance`
 
 ```bash
-gh pr create --base <target-branch> --title "<title>" --body "$(cat <<'EOF'
+gh pr create --base <target-branch> --title "<title>" --assignee @me --body "$(cat <<'EOF'
 <Complete PR description following template>
 
 Generated with AI assistance
@@ -93,7 +102,21 @@ gh label list --search "type:" --limit 1 --json name --jq 'length'
 - returns `0` -> run the `init-labels` skill first, then retry this step
 - returns non-zero -> continue
 
-**b) Sync the type label**
+**b) Query Issue metadata**
+
+If task.md contains `issue_number`, query the Issue labels and milestone on a best-effort basis:
+
+```bash
+gh issue view {issue-number} --json labels,milestone 2>/dev/null
+```
+
+If the query fails (Issue not found, permission denied, etc.), skip Issue metadata inheritance and continue with only the static mappings from task.md.
+
+Record the results for later substeps:
+- `{issue-labels}`: list of labels currently on the Issue
+- `{issue-milestone}`: title of the Issue milestone, if present
+
+**c) Sync the type label**
 
 Map task.md `type` using this table:
 
@@ -114,7 +137,17 @@ If task.md `type` maps to a standard type label, run:
 gh pr edit {pr-number} --add-label "{type-label}"
 ```
 
-**c) Sync `in:` labels**
+**d) Inherit Issue labels**
+
+If `{issue-labels}` is not empty, filter labels that do not start with `type:` or `status:` and run the following for each label on a best-effort basis:
+
+```bash
+gh pr edit {pr-number} --add-label "{label-name}"
+```
+
+Only add labels; do not remove any existing PR labels.
+
+**e) Sync `in:` labels**
 
 Extract affected modules from implementation reports or analysis, verify that the label exists, then run:
 
@@ -124,11 +157,12 @@ gh pr edit {pr-number} --add-label "in: {module}"
 
 Only add labels; do not remove existing `in:` labels.
 
-**d) Sync the milestone**
+**f) Sync the milestone**
 
-Reuse the same milestone inference strategy as `sync-pr`:
+Extend the `sync-pr` milestone inference strategy with Issue milestone priority:
 - preserve an existing PR milestone
 - otherwise respect explicit `milestone` from task.md
+- otherwise use the Issue milestone when available (`{issue-milestone}`)
 - otherwise infer from the current branch, release branches, or the latest tag
 - finally fall back to `General Backlog`
 
@@ -138,7 +172,7 @@ Once the target is resolved, run:
 gh pr edit {pr-number} --milestone "{milestone-title}"
 ```
 
-**e) Sync development linking**
+**g) Sync development linking**
 
 If task.md contains `issue_number`, read the PR body:
 
@@ -170,7 +204,7 @@ Get the current time:
 date "+%Y-%m-%d %H:%M:%S"
 ```
 
-If there is an active task for this work, update `.agent-workspace/active/{task-id}/task.md`:
+If there is an active task for this work, update `.agents/workspace/active/{task-id}/task.md`:
 - `pr_number`: {pr-number}
 - `updated_at`: {current time}
 - **Append** to `## Activity Log` (do NOT overwrite previous entries):
@@ -222,3 +256,6 @@ Next steps (if in task workflow):
 - No commits to push: Prompt "No commits found between {target} and HEAD"
 - Push rejected: Suggest `git pull --rebase` first
 - PR already exists: Show existing PR URL
+- Issue not accessible or missing: Skip Issue metadata inheritance and record "Issue #{number} not accessible, skipping metadata inheritance"
+- Issue label unavailable: Skip that label and record "Label '{name}' not found, skipping"
+- Issue milestone unavailable: Fall back to branch-based milestone inference

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

@@ -63,13 +63,22 @@ git push -u origin <current-branch>
 
 ### 7. 创建 PR
 
+- 如果存在关联的活跃任务，从 task.md 提取 `issue_number`
+- 如果 `issue_number` 存在，查询 Issue 信息（容错，失败时跳过）：
+  ```bash
+  gh issue view {issue-number} --json number,title --jq '.number' 2>/dev/null
+  ```
 - 遵循 `.github/PULL_REQUEST_TEMPLATE.md` 格式填写所有部分
 - 参考最近合并的 PR 的风格
 - 使用 HEREDOC 格式传递 body
+- 如果 `issue_number` 存在：
+  - 将模板中的 `{$IssueNumber}` 替换为实际 Issue 编号
+  - 在 `Related Issue` 部分使用 `Closes #{issue_number}`
+- 如果 `issue_number` 不存在，保持原有行为
 - PR 必须以 `Generated with AI assistance` 结尾
 
 ```bash
-gh pr create --base <target-branch> --title "<title>" --body "$(cat <<'EOF'
+gh pr create --base <target-branch> --title "<title>" --assignee @me --body "$(cat <<'EOF'
 <按模板填写的完整 PR 描述>
 
 Generated with AI assistance
@@ -92,7 +101,21 @@ gh label list --search "type:" --limit 1 --json name --jq 'length'
 - 返回 `0` -> 先执行 `init-labels` 技能，然后重新执行本步骤
 - 返回非 `0` -> 继续
 
-**b) 同步 type label**
+**b) 查询 Issue 元数据**
+
+如果 task.md 包含 `issue_number`，查询 Issue 的 Labels 和 Milestone（容错）：
+
+```bash
+gh issue view {issue-number} --json labels,milestone 2>/dev/null
+```
+
+如果查询失败（Issue 不存在、权限不足等），跳过 Issue 元数据继承，后续步骤仅使用 task.md 静态映射。
+
+记录查询结果供后续子步骤使用：
+- `{issue-labels}` — Issue 上的 Labels 列表
+- `{issue-milestone}` — Issue 上的 Milestone 标题（如有）
+
+**c) 同步 type label**
 
 根据 task.md 的 `type` 字段按下表映射：
 
@@ -113,7 +136,17 @@ gh label list --search "type:" --limit 1 --json name --jq 'length'
 gh pr edit {pr-number} --add-label "{type-label}"
 ```
 
-**c) 同步 in: label**
+**d) 继承 Issue Labels**
+
+如果 `{issue-labels}` 非空，筛选出不以 `type:` 或 `status:` 开头的 labels，对每个 label 执行（容错，label 不存在时跳过）：
+
+```bash
+gh pr edit {pr-number} --add-label "{label-name}"
+```
+
+只添加，不移除 PR 上现有的 labels。
+
+**e) 同步 in: label**
 
 从实现报告或分析报告提取受影响模块，确认对应 label 存在后执行：
 
@@ -123,11 +156,12 @@ gh pr edit {pr-number} --add-label "in: {module}"
 
 只添加，不移除现有的 `in:` labels。
 
-**d) 同步 Milestone**
+**f) 同步 Milestone**
 
-复用 `sync-pr` 的里程碑推断策略：
+基于 `sync-pr` 的里程碑推断策略，并扩展 Issue Milestone 优先级：
 - 先检查 PR 是否已有 milestone
 - 再检查 task.md 是否显式指定 `milestone`
+- 再检查 Issue 是否已有 milestone（使用 `{issue-milestone}`）
 - 否则基于当前分支、版本分支或最新 tag 推断
 - 最终回退到 `General Backlog`
 
@@ -137,7 +171,7 @@ gh pr edit {pr-number} --add-label "in: {module}"
 gh pr edit {pr-number} --milestone "{milestone-title}"
 ```
 
-**e) 同步 Development 关联**
+**g) 同步 Development 关联**
 
 如果 task.md 包含 `issue_number`，读取 PR body：
 
@@ -169,7 +203,7 @@ EOF
 date "+%Y-%m-%d %H:%M:%S"
 ```
 
-如果有关联的活跃任务，更新 `.agent-workspace/active/{task-id}/task.md`：
+如果有关联的活跃任务，更新 `.agents/workspace/active/{task-id}/task.md`：
 - `pr_number`：{pr-number}
 - `updated_at`：{当前时间}
 - **追加**到 `## Activity Log`（不要覆盖之前的记录）：
@@ -221,3 +255,6 @@ PR 已创建：{pr-url}
 - 无提交可推送：提示 "No commits found between {target} and HEAD"
 - 推送被拒绝：建议先执行 `git pull --rebase`
 - PR 已存在：显示已有的 PR URL
+- Issue 不存在或无权限：跳过 Issue 元数据继承，记录 "Issue #{number} not accessible, skipping metadata inheritance"
+- Issue Label 不可用：跳过对应 label，记录 "Label '{name}' not found, skipping"
+- Issue Milestone 不可用：回退到分支推断策略

package/templates/.agents/skills/create-release-note/SKILL.md

@@ -34,22 +34,29 @@ git rev-parse v<version>
 git rev-parse v<prev-version>
 ```
 
-### Step 3: Reference Historical Release Notes Format
+### Step 3: Reference Historical Release Notes Format and Categories
 
-Fetch the most recent published release notes as a format reference:
+Fetch multiple published release notes as format references, then use a predefined complete category list:
 
 ```bash
-# Get the latest non-draft release tag
-gh release list --limit 5 --json tagName,isDraft,isPrerelease \
-  --jq '[.[] | select(.isDraft == false and .isPrerelease == false)][0].tagName'
-
-# Get the release body
-gh release view <latest-tag> --json body -q '.body'
+# Part A: Fetch the body for each of the 3 releases
+for tag in $(gh release list --limit 10 --json tagName,isDraft,isPrerelease \
+  --jq '[.[] | select(.isDraft == false and .isPrerelease == false)] | .[0:3] | .[].tagName'); do
+  gh release view "$tag" --json body -q '.body'
+done
 ```
 
+**Part B: Complete Category List**
+- `🆕 Feature`
+- `✨ Enhancement`
+- `✅ Bugfix`
+- `📚 Documentation`
+
 **Purpose**:
-- Analyze the section structure, heading style, emoji usage, and item format of historical release notes
-- When generating release notes in Step 7, **must** follow the historical format to maintain consistency across versions
+- Part A: Analyze the section structure, heading style, emoji usage, and item format from the latest 3 historical release notes
+- Part B: Provide a static complete category list so no existing category is omitted
+- This static list ensures existing category names are not missed during classification; if the current release has no entries for a category, Step 7 still omits the empty section
+- When generating release notes in Step 7, **must** follow both the historical format style and the full category list gathered in Step 3
 - If no historical release notes exist, use the default format defined in Step 7
 
 ### Step 4: Collect Merged PRs
@@ -94,7 +101,7 @@ gh issue view <N> --json number,title,labels,url
 
 ### Step 7: Generate Release Notes
 
-**Prioritize the historical format obtained in Step 3.** If historical release notes exist, strictly follow their section structure, heading style (including emojis), item format, and bilingual layout.
+**Prioritize the historical format style obtained in Step 3 and ensure all categories listed in Step 3 are covered.** If historical release notes exist, strictly follow their section structure, heading style (including emojis), item format, and bilingual layout.
 
 If no historical release notes exist, use the following default Markdown format:
 

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

@@ -33,22 +33,29 @@ git rev-parse v<version>
 git rev-parse v<prev-version>
 ```
 
-### 步骤 3：参考历史发布说明格式
+### 步骤 3：参考历史发布说明格式与分类
 
-获取最近一次已发布的 Release Note 作为格式参考：
+获取最近多条已发布的 Release Note 作为格式参考，并参考预定义的完整分类清单：
 
 ```bash
-# 获取最近的非草稿 Release 标签
-gh release list --limit 5 --json tagName,isDraft,isPrerelease \
-  --jq '[.[] | select(.isDraft == false and .isPrerelease == false)][0].tagName'
-
-# 获取该 Release 的 body
-gh release view <latest-tag> --json body -q '.body'
+# Part A: 逐条获取这 3 条 Release 的 body
+for tag in $(gh release list --limit 10 --json tagName,isDraft,isPrerelease \
+  --jq '[.[] | select(.isDraft == false and .isPrerelease == false)] | .[0:3] | .[].tagName'); do
+  gh release view "$tag" --json body -q '.body'
+done
 ```
 
+**Part B：完整分类清单**
+- `🆕 Feature`
+- `✨ Enhancement`
+- `✅ Bugfix`
+- `📚 Documentation`
+
 **用途**：
-- 分析历史发布说明的章节结构、标题风格、emoji 使用、条目格式
-- 后续步骤 7 生成发布说明时，**必须**优先遵循历史格式，保持版本间的一致性
+- Part A：分析最近 3 条历史发布说明的章节结构、标题风格、emoji 使用、条目格式
+- Part B：提供静态完整分类清单，确保后续生成时不遗漏已有分类
+- 该静态清单用于确保变更分类时不遗漏已有类别名称；若当前版本无该类变更，仍按步骤 7 的格式规则省略空分类
+- 后续步骤 7 生成发布说明时，**必须**同时参考步骤 3 的历史格式风格和完整分类清单，保持版本间的一致性
 - 如果没有历史发布说明，则使用步骤 7 中定义的默认格式
 
 ### 步骤 4：收集已合并的 PR
@@ -93,7 +100,7 @@ gh issue view <N> --json number,title,labels,url
 
 ### 步骤 7：生成发布说明
 
-**优先使用步骤 3 中获取的历史格式**。如果存在历史发布说明，严格沿用其章节结构、标题风格（含 emoji）、条目格式和双语布局。
+**优先使用步骤 3 中获取的历史格式风格，并确保覆盖步骤 3 列出的所有分类。** 如果存在历史发布说明，严格沿用其章节结构、标题风格（含 emoji）、条目格式和双语布局。
 
 如果没有历史发布说明，使用以下默认格式化为 Markdown：
 

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

@@ -1,67 +1,69 @@
 ---
 name: create-task
 description: >
-  根据用户的自然语言描述创建任务骨架。当用户描述一个新功能、Bug 或改进需求时触发。
-  唯一的产出是 task.md —— 不编写任何业务代码。参数：任务描述文本。
+  Create a task skeleton from the user's natural-language description.
+  Triggered when the user describes a new feature, bug, or improvement request.
+  The only output is task.md; do not write any business code. Argument: task description text.
 ---
 
-# 创建任务
+# Create Task
 
-## 行为边界 / 关键规则
+## Boundary / Critical Rules
 
-**本技能的唯一产出是 `task.md`。**
+**The only output of this skill is `task.md`.**
 
-- 不要编写、修改或创建任何业务代码或配置文件
-- 不要执行需求分析；分析由 `analyze-task` 独立完成
-- 不要直接实现所描述的功能
-- 不要跳过工作流直接进入计划/实现阶段
-- 仅执行：解析描述 -> 创建任务文件 -> 更新任务状态 -> 告知用户下一步
+- Do not write, modify, or create any business code or configuration files
+- Do not perform requirements analysis; analysis is handled separately by `analyze-task`
+- Do not directly implement the requested functionality
+- Do not skip the workflow and jump directly to planning or implementation
+- Only do this: parse the description -> create the task file -> update task status -> inform the user of the next step
 
-用户的描述是一个**待办事项**，而不是**立即执行的指令**。
+The user's description is a **work item**, not an **instruction to execute immediately**.
 
-执行本技能后，你**必须**立即更新 task.md 中的任务状态。
+After executing this skill, you **must** immediately update task status in task.md.
 
-## 执行步骤
+## Steps
 
-### 1. 解析用户描述
+### 1. Parse the User Description
 
-从自然语言描述中提取：
-- **任务标题**：简洁标题（最多 50 个字符）
-- **任务类型**：`feature` | `bugfix` | `refactor` | `docs` | `chore`（从描述推断）
-- **工作流**：`feature-development` | `bug-fix` | `refactoring`（从类型推断）
-- **详细描述**：整理后的用户原始描述
+Extract from the natural-language description:
+- **Task title**: a concise title (maximum 50 characters)
+- **Task type**: `feature` | `bugfix` | `refactor` | `docs` | `chore` (infer from the description)
+- **Workflow**: `feature-development` | `bug-fix` | `refactoring` (infer from the type)
+- **Detailed description**: the cleaned-up original user request
 
-如果描述不清晰，**先向用户确认**再继续。
+If the description is unclear, **ask the user to clarify first**.
 
-**类型推断规则**：
-- 包含 "add"、"new"、"support"、"implement" -> `feature`
-- 包含 "fix"、"resolve"、"bug"、"error" -> `bugfix`
-- 包含 "refactor"、"optimize"、"improve"、"clean up" -> `refactor`
-- 包含 "document"、"javadoc"、"comment"、"readme" -> `docs`
-- 其他 -> `chore`
+**Type inference**: choose the best matching type from the following candidates based on the semantics of the task description:
 
-**工作流映射**：
+- `feature` - new functionality or capability
+- `bugfix` - defect or error fix
+- `refactor` - refactoring, optimization, or code improvement
+- `docs` - documentation-related work
+- `chore` - other miscellaneous work
+
+**Workflow mapping**:
 - `feature` / `docs` / `chore` -> `feature-development`
 - `bugfix` -> `bug-fix`
 - `refactor` -> `refactoring`
 
-### 2. 创建任务目录和文件
+### 2. Create the Task Directory and File
 
-获取当前时间戳：
+Get the current timestamp:
 
 ```bash
 date +%Y%m%d-%H%M%S
 ```
 
-- 创建任务目录：`.agent-workspace/active/TASK-{yyyyMMdd-HHmmss}/`
-- 使用 `.agents/templates/task.md` 模板创建任务文件：`task.md`
+- Create the task directory: `.agents/workspace/active/TASK-{yyyyMMdd-HHmmss}/`
+- Use the `.agents/templates/task.md` template to create the task file: `task.md`
 
-**重要**：
-- 目录命名：`TASK-{yyyyMMdd-HHmmss}`（**必须**包含 `TASK-` 前缀）
-- 示例：`TASK-20260306-143022`
-- 任务 ID = 目录名
+**Important**:
+- Directory naming: `TASK-{yyyyMMdd-HHmmss}` (**must** include the `TASK-` prefix)
+- Example: `TASK-20260306-143022`
+- Task ID = directory name
 
-任务元数据（task.md YAML front matter）：
+Task metadata (`task.md` YAML front matter):
 ```yaml
 id: TASK-{yyyyMMdd-HHmmss}
 type: feature|bugfix|refactor|docs|chore
@@ -71,73 +73,73 @@ created_at: {yyyy-MM-dd HH:mm:ss}
 updated_at: {yyyy-MM-dd HH:mm:ss}
 created_by: human
 current_step: requirement-analysis
-assigned_to: {当前 AI 代理}
+assigned_to: {current AI agent}
 ```
 
-注意：`created_by` 为 `human`，因为任务来源于用户的描述。
+Note: `created_by` is `human` because the task comes from the user's description.
 
-### 3. 更新任务状态
+### 3. Update Task Status
 
-获取当前时间：
+Get the current time:
 
 ```bash
 date "+%Y-%m-%d %H:%M:%S"
 ```
 
-更新 `.agent-workspace/active/{task-id}/task.md`：
-- `current_step`：requirement-analysis
-- `assigned_to`：{当前 AI 代理}
-- `updated_at`：{当前时间}
-- **追加**到 `## Activity Log`（不要覆盖之前的记录）：
+Update `.agents/workspace/active/{task-id}/task.md`:
+- `current_step`: requirement-analysis
+- `assigned_to`: {current AI agent}
+- `updated_at`: {current time}
+- **Append** to `## Activity Log` (do NOT overwrite previous entries):
   ```
   - {yyyy-MM-dd HH:mm:ss} — **Task Created** by {agent} — Task created from description
   ```
 
-### 4. 告知用户
+### 4. Inform User
 
-> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
 
-输出格式：
+Output format:
 ```
-任务已创建。
+Task created.
 
-任务信息：
-- 任务 ID：{task-id}
-- 标题：{title}
-- 类型：{type}
-- 工作流：{workflow}
+Task information:
+- Task ID: {task-id}
+- Title: {title}
+- Type: {type}
+- Workflow: {workflow}
 
-产出文件：
-- 任务文件：.agent-workspace/active/{task-id}/task.md
+Output file:
+- Task file: .agents/workspace/active/{task-id}/task.md
 
-下一步 - 执行需求分析：
-  - Claude Code / OpenCode：/analyze-task {task-id}
-  - Gemini CLI：/agent-infra:analyze-task {task-id}
-  - Codex CLI：$analyze-task {task-id}
+Next step - run requirements analysis:
+  - Claude Code / OpenCode: /analyze-task {task-id}
+  - Gemini CLI: /{{project}}:analyze-task {task-id}
+  - Codex CLI: $analyze-task {task-id}
 ```
 
-## 完成检查清单
+## Completion Checklist
 
-- [ ] 创建了任务文件 `.agent-workspace/active/{task-id}/task.md`
-- [ ] 更新了 task.md 中的 `current_step` 为 requirement-analysis
-- [ ] 更新了 task.md 中的 `updated_at` 为当前时间
-- [ ] 更新了 task.md 中的 `assigned_to`
-- [ ] 追加了 Activity Log 条目到 task.md
-- [ ] 告知了用户下一步（必须展示所有 TUI 的命令格式，不要筛选）
-- [ ] **没有修改任何业务代码或配置文件**（仅 task.md）
+- [ ] Created the task file `.agents/workspace/active/{task-id}/task.md`
+- [ ] Updated `current_step` to requirement-analysis in task.md
+- [ ] Updated `updated_at` to the current time in task.md
+- [ ] Updated `assigned_to` in task.md
+- [ ] Appended an Activity Log entry to task.md
+- [ ] Informed the user of the next step (must include all TUI command formats; do not filter)
+- [ ] **Did not modify any business code or configuration files** (only task.md)
 
-## 停止
+## STOP
 
-完成检查清单后，**立即停止**。不要继续执行计划、实现或任何后续步骤。
-等待用户执行 `analyze-task` 技能。
+After completing the checklist, **stop immediately**. Do not continue to planning, implementation, or any follow-up step.
+Wait for the user to run the `analyze-task` skill.
 
-## 注意事项
+## Notes
 
-1. **清晰度**：如果用户描述模糊或缺少关键信息，先要求澄清
-2. **与 import-issue 的区别**：`import-issue` 从 GitHub Issue 导入任务；`create-task` 从自由描述创建
-3. **工作流顺序**：创建任务后，必须先执行 `analyze-task`，再进入 `plan-task`
+1. **Clarity**: if the user description is vague or missing key information, ask for clarification first
+2. **Difference from `import-issue`**: `import-issue` imports from a GitHub Issue; `create-task` creates from a free-form description
+3. **Workflow order**: after creating a task, `analyze-task` must run before `plan-task`
 
-## 错误处理
+## Error Handling
 
-- 空描述：提示 "Please provide a task description"
-- 描述过于模糊：在创建任务之前提出澄清问题
+- Empty description: output "Please provide a task description"
+- Description too vague: ask clarification questions before creating the task