@fitlab-ai/agent-infra 0.4.0 → 0.4.1

package/templates/.gemini/commands/_project_/upgrade-dependency.zh-CN.toml

@@ -1,4 +1,4 @@
-description = "升级项目中的指定依赖包到新版本并验证变更。 当用户要求升级依赖时触发。参数：包名、原版本和新版本。"
+description = "升级项目依赖到新版本并验证"
 prompt = """
 升级依赖：{{args}}
 

package/templates/.github/hooks/check-version-format.sh

@@ -0,0 +1,29 @@
+#!/bin/sh
+set -e
+
+script_dir=$(
+  CDPATH= cd -- "$(dirname -- "$0")" && pwd
+)
+repo_root=$(
+  CDPATH= cd -- "$script_dir/../.." && pwd
+)
+
+airc_file="$repo_root/.agents/.airc.json"
+
+if [ ! -f "$airc_file" ]; then
+  exit 0
+fi
+
+template_version=$(
+  node -e "const fs = require('node:fs'); const data = JSON.parse(fs.readFileSync(process.argv[1], 'utf8')); if (typeof data.templateVersion !== 'string') process.exit(1); process.stdout.write(data.templateVersion);" "$airc_file"
+) || {
+  echo "Error: Failed to read templateVersion from .agents/.airc.json."
+  exit 1
+}
+
+if ! printf '%s\n' "$template_version" | grep -Eq '^v[0-9]+\.[0-9]+\.[0-9]+$'; then
+  echo "Error: .agents/.airc.json templateVersion must use v-prefixed semver (found: $template_version)."
+  exit 1
+fi
+
+echo "Version format check passed."

package/templates/.github/hooks/pre-commit

@@ -0,0 +1,8 @@
+#!/bin/sh
+set -e
+
+script_dir=$(
+  CDPATH= cd -- "$(dirname -- "$0")" && pwd
+)
+
+"$script_dir/check-version-format.sh"

package/templates/.opencode/commands/analyze-task.md

@@ -1,5 +1,5 @@
 ---
-description: "Analyze an existing task and output a requirement analysis document"
+description: "Analyze a task and produce a requirements document"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/analyze-task.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "分析已有任务并输出需求分析文档，支持多轮分析产物。 当用户要求分析某个任务时触发。参数：task-id。"
+description: "分析任务并输出需求分析文档"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/block-task.md

@@ -1,5 +1,5 @@
 ---
-description: "Mark task as blocked and record blocking reason"
+description: "Mark a task as blocked and record the reason"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/block-task.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "标记任务为阻塞状态并记录阻塞原因，将其从 active 目录移动到 blocked 目录。 当任务因技术问题、需求不清晰、缺少资源或待定决策而无法继续时使用。 参数：task-id，可选的阻塞原因。"
+description: "标记任务为阻塞状态并记录原因"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/check-task.md

@@ -1,5 +1,5 @@
 ---
-description: "View task current status and progress"
+description: "Check a task's current status and progress"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/check-task.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "查看任务的当前状态、工作流进度和上下文文件。这是只读操作，报告任务状态并建议 适当的下一步操作。当用户要求查看任务状态时触发。参数：task-id。"
+description: "查看任务的当前状态和进度"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/close-codescan.md

@@ -1,5 +1,5 @@
 ---
-description: "Close Code Scanning alert with documented reason"
+description: "Close a Code Scanning alert with a documented reason"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/close-codescan.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "关闭 Code Scanning（CodeQL）告警并提供有据可查的理由。 当用户要求关闭 Code Scanning 告警时触发。参数：告警编号。"
+description: "关闭 Code Scanning 告警并记录理由"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/close-dependabot.md

@@ -1,5 +1,5 @@
 ---
-description: "Close Dependabot security alert with documented reason"
+description: "Close a Dependabot alert with a documented reason"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/close-dependabot.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "关闭 Dependabot 安全告警并提供有据可查的理由。 当用户要求关闭 Dependabot 告警时触发。参数：告警编号。"
+description: "关闭 Dependabot 安全告警并记录理由"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/commit.md

@@ -1,5 +1,5 @@
 ---
-description: "Commit current changes to Git"
+description: "Commit the current changes to Git"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/commit.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "提交当前变更到 Git，包含版权头年份检查和任务状态更新。 当用户要求提交代码或保存变更时触发。"
+description: "提交当前变更到 Git"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/complete-task.md

@@ -1,5 +1,5 @@
 ---
-description: "Mark task completed and archive to completed directory"
+description: "Mark a task as completed and archive it"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/complete-task.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "标记任务完成并归档，将任务目录从 active/ 移动到 completed/。在允许完成之前， 验证所有工作流步骤已完成、代码已审查并提交、测试已通过。 当用户要求完成或归档任务时触发。参数：task-id。"
+description: "标记任务完成并归档"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/create-issue.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "从任务文件创建 GitHub Issue。 当用户要求为任务创建 Issue 时触发。参数：task-id。"
+description: "从任务文件创建 GitHub Issue"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/create-pr.md

@@ -1,5 +1,5 @@
 ---
-description: "Create Pull Request to specified or auto-detected target branch"
+description: "Create a Pull Request to a target branch"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/create-pr.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "创建 Pull Request 到指定或自动推断的目标分支。 当用户要求创建 PR 时触发。可选参数：目标分支。"
+description: "创建 Pull Request 到目标分支"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/create-release-note.md

@@ -1,5 +1,5 @@
 ---
-description: "Auto-generate structured Release Notes from PR/commit and optionally create GitHub Draft Release"
+description: "Generate release notes from PRs and commits"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/create-release-note.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "从 PR 和 commit 生成版本发布说明。 当用户要求生成发布说明时触发。参数：版本号，可选的上一版本号。"
+description: "从 PR 和 commit 生成版本发布说明"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/create-task.md

@@ -1,5 +1,5 @@
 ---
-description: "Create task from natural language description and generate requirement analysis document"
+description: "Create a task from a natural-language description"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/create-task.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "根据用户的自然语言描述创建任务并执行需求分析。当用户描述一个新功能、Bug 或改进需求时触发。 唯一的产出是 task.md 和 analysis.md —— 不编写任何业务代码。参数：任务描述文本。"
+description: "根据自然语言描述创建任务"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/implement-task.md

@@ -1,5 +1,5 @@
 ---
-description: "Implement task based on technical plan and output implementation report"
+description: "Implement a task from its technical plan and output a report"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/implement-task.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "根据技术方案实施任务，编写代码和测试，输出实现报告。当用户在技术方案审查通过后要求实施任务或编码时触发。 参数：task-id。"
+description: "根据技术方案实施任务并输出报告"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/import-codescan.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "导入 Code Scanning（CodeQL）告警并创建修复任务。 当用户要求导入 Code Scanning 告警时触发。参数：告警编号。"
+description: "导入 Code Scanning 告警并创建修复任务"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/import-dependabot.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "导入 Dependabot 安全告警并创建修复任务。 当用户要求导入 Dependabot 告警时触发。参数：告警编号。"
+description: "导入 Dependabot 安全告警并创建修复任务"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/import-issue.md

@@ -1,5 +1,5 @@
 ---
-description: "Import a GitHub Issue and create a task file"
+description: "Import a GitHub Issue and create a task"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/import-issue.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "从 GitHub Issue 导入并创建任务文件。 当用户要求导入某个 Issue 时触发。参数：issue 编号。"
+description: "从 GitHub Issue 导入并创建任务"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/init-labels.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "一次性初始化仓库的标准 GitHub Labels 体系。创建通用 labels、自动探测 in: labels、不生成 theme: labels，并提示未覆盖的默认 labels。"
+description: "初始化仓库的 GitHub Labels 体系"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/init-milestones.md

@@ -1,5 +1,5 @@
 ---
-description: "Initialize the repository's standard GitHub Milestones taxonomy and optionally backfill historical milestones with --history"
+description: "Initialize the repository's standard GitHub Milestones taxonomy"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/init-milestones.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "一次性初始化仓库的标准 GitHub Milestones 体系。创建 General Backlog、基于当前版本的初始里程碑，并可选通过 --history 补齐历史版本里程碑。"
+description: "初始化仓库的 GitHub Milestones 体系"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/plan-task.md

@@ -1,5 +1,5 @@
 ---
-description: "Design technical solution and output implementation plan"
+description: "Design a technical plan for a task"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/plan-task.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "为任务设计技术方案并输出详细的实施计划。当用户要求为已完成需求分析的任务设计方案或技术计划时触发。 这是一个强制性的人工审查检查点。参数：task-id。"
+description: "为任务设计技术方案和实施计划"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/refine-task.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "处理代码审查反馈并修复审查中发现的问题。按优先级（Blocker -> Major -> Minor）修复。 仅处理审查中标记的问题，不添加额外变更。当用户要求修复审查问题时触发。参数：task-id。"
+description: "处理代码审查反馈并修复问题"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/refine-title.md

@@ -1,5 +1,5 @@
 ---
-description: "Deep-analyze Issue or PR content and reformat its title to Conventional Commits format"
+description: "Rewrite an Issue or PR title in Conventional Commits format"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/refine-title.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "深度分析 Issue 或 PR 内容，并将其标题重构为 Conventional Commits 格式。 当用户要求优化标题时触发。参数：issue 或 PR 编号。"
+description: "重构 Issue/PR 标题为 Conventional Commits 格式"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/release.md

@@ -1,5 +1,5 @@
 ---
-description: "Execute version release workflow"
+description: "Run the version release workflow"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/release.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "执行版本发布流程。当用户要求发布版本时触发。参数：版本号（X.Y.Z）。"
+description: "执行版本发布流程"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/review-task.md

@@ -1,5 +1,5 @@
 ---
-description: "Review task implementation and output code review report"
+description: "Review a task implementation and output a code review report"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/review-task.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "审查任务实现代码并输出代码审查报告，按严重程度分类（Blocker / Major / Minor）。 当用户在实现完成后要求代码审查时触发。参数：task-id。"
+description: "审查任务实现并输出代码审查报告"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/sync-issue.md

@@ -1,5 +1,5 @@
 ---
-description: "Sync task progress to GitHub Issue comment"
+description: "Sync task progress to a GitHub Issue"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/sync-issue.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "将任务处理进度同步到对应的 GitHub Issue 评论。 当用户要求同步进度到 Issue 时触发。参数：task-id。"
+description: "将任务进度同步到 GitHub Issue"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/sync-pr.md

@@ -1,5 +1,5 @@
 ---
-description: "Sync task progress to Pull Request comment"
+description: "Sync task progress to a Pull Request"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/sync-pr.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "将任务处理进度同步到对应的 Pull Request 评论。 当用户要求同步进度到 PR 时触发。参数：task-id。"
+description: "将任务进度同步到 Pull Request"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/test-integration.md

@@ -1,5 +1,5 @@
 ---
-description: "Run integration test workflow"
+description: "Run the integration test workflow"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/test-integration.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "执行项目集成测试流程。 当用户要求运行集成测试或端到端验证时触发。"
+description: "执行项目集成测试流程"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/test.md

@@ -1,5 +1,5 @@
 ---
-description: "Run full test workflow (compilation + unit tests)"
+description: "Run the full project test workflow"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/test.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "执行项目完整测试流程（编译检查 + 单元测试）。 当用户要求运行测试或验证代码质量时触发。"
+description: "执行项目完整测试流程"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/update-agent-infra.md

@@ -1,5 +1,5 @@
 ---
-description: "Update project AI collaboration config by re-rendering latest templates/"
+description: "Update the project AI collaboration configuration"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/update-agent-infra.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "通过重新渲染最新 templates/ 来更新项目 AI 协作配置"
+description: "更新项目 AI 协作配置"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/upgrade-dependency.md

@@ -1,5 +1,5 @@
 ---
-description: "Upgrade dependency package to new version"
+description: "Upgrade a dependency and validate the change"
 agent: general
 subtask: false
 ---

package/templates/.opencode/commands/upgrade-dependency.zh-CN.md

@@ -1,5 +1,5 @@
 ---
-description: "升级项目中的指定依赖包到新版本并验证变更。 当用户要求升级依赖时触发。参数：包名、原版本和新版本。"
+description: "升级项目依赖到新版本并验证"
 agent: general
 subtask: false
 ---

package/templates/AGENTS.md

@@ -88,14 +88,22 @@ All code-level content uses **English**. Documentation provides **multilingual v
 
 ## Skill Authoring Conventions
 
-When writing or updating `.agents/skills/*/SKILL.md` files, keep step numbering consistent:
+When writing or updating `.agents/skills/*/SKILL.md` files and their templates, keep step numbering consistent:
 
 1. Use consecutive integers for top-level steps: `1.`, `2.`, `3.`.
 2. Use nested numbering only for child actions that belong to a parent step: `1.1`, `1.2`, `2.1`.
-3. Use `a`, `b`, and `c` markers for branches, conditions, or alternative paths within the same step.
+3. Use `a`, `b`, and `c` markers for subordinate options, conditional branches, or parallel possibilities within the same step; use them only for in-step expansion, not for naming standalone decision paths or output templates.
 4. Do not use intermediate numbers such as `1.5` or `2.5`; if a new standalone step is needed, renumber the following top-level steps.
 5. When renumbering, update every in-document step reference so the instructions remain accurate.
 6. Extract long bash scripts into a sibling `scripts/` directory; the SKILL.md should contain only a single-line invocation (e.g., `bash .agents/skills/<skill>/scripts/<script>.sh`) and a brief summary of the script's responsibilities.
+7. In SKILL.md files and their `reference/` templates, when a standalone conditional flow, decision path, or output template needs a label, use "Scenario" naming (for example, use "Scenario A").
+
+### SKILL.md Size Control
+
+- Keep the SKILL.md body within about 500 tokens (roughly 80 lines / 2KB).
+- Move content beyond that threshold into a sibling `reference/` directory.
+- Use explicit navigation in the skeleton, such as: `Read reference/xxx.md before executing this step.`
+- Keep scripts in `scripts/` and execute them instead of inlining long bash blocks.
 
 <!-- Canonical source: .agents/README.md - keep in sync -->
 

package/templates/AGENTS.zh-CN.md

@@ -88,14 +88,22 @@ refactor(module): refactor internal logic
 
 ## Skill 编写规范
 
-编写或维护 `.agents/skills/*/SKILL.md` 时，步骤编号遵循以下规则：
+编写或维护 `.agents/skills/*/SKILL.md` 及其模板时，步骤编号遵循以下规则：
 
 1. 顶级步骤使用连续整数：`1.`、`2.`、`3.`。
 2. 只有父步骤下的从属动作才使用子步骤：`1.1`、`1.2`、`2.1`。
-3. 同一步中的分支、条件或多种可能性使用 `a`、`b`、`c` 标记。
+3. 同一步中的从属选项、条件分支或并列可能性使用 `a`、`b`、`c` 标记；仅用于步骤内部的子项展开，不用于命名独立的决策路径或输出模板。
 4. 不要使用 `1.5`、`2.5` 这类中间编号；如新增独立步骤，应整体顺延后续编号。
 5. 调整编号时，必须同步更新文中的步骤引用，确保说明、命令和检查点一致。
 6. 长 bash 脚本应从 SKILL.md 提取到同级 `scripts/` 目录中，SKILL.md 只保留单行调用（如 `bash .agents/skills/<skill>/scripts/<script>.sh`）和对脚本职责的概要说明。
+7. 在 SKILL.md 及其 `reference/` 模板中，如需为独立的条件分流、决策路径或输出模板命名，统一使用“场景”命名（例如使用“场景 A”）。
+
+### SKILL.md 体积控制
+
+- SKILL.md 正文控制在约 500 tokens（约 80 行 / 2KB）以内。
+- 超过阈值的内容拆分到同级 `reference/` 目录。
+- 骨架中使用明确导航，例如：`执行此步骤前，先读取 reference/xxx.md。`
+- 长脚本继续放在 `scripts/` 目录，优先执行脚本而不是内联大段 bash。
 
 <!-- Canonical source: .agents/README.zh-CN.md - keep in sync -->