@fitlab-ai/agent-infra 0.3.2 → 0.4.1

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

@@ -63,7 +63,7 @@ Before submitting a PR, ensure:
 ## Security Notes
 
 - Do not commit sensitive files: `.env`, `credentials.json`, keys, etc.
-- Report security issues per `SECURITY.md` guidelines (do not open public Issues)
+- Handle security issues privately according to your project's disclosure policy (do not open public Issues)
 
 ## Multi-AI Collaboration Support
 
@@ -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

@@ -63,7 +63,7 @@ refactor(module): refactor internal logic
 ## 安全注意事项
 
 - 不要提交敏感文件：`.env`, `credentials.json`, 密钥等
-- 安全问题请按 `SECURITY.md` 指引私下提交（不要公开 Issue）
+- 安全问题请按项目自己的披露流程私下处理（不要公开 Issue）
 
 ## 多 AI 协作支持
 
@@ -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 -->
 

package/templates/.editorconfig

@@ -1,15 +0,0 @@
-root = true
-
-[*]
-charset = utf-8
-end_of_line = lf
-insert_final_newline = true
-trim_trailing_whitespace = true
-indent_style = space
-indent_size = 2
-
-[*.md]
-trim_trailing_whitespace = false
-
-[Makefile]
-indent_style = tab

package/templates/.github/ISSUE_TEMPLATE/01_bug_report.yml

@@ -1,149 +0,0 @@
-name: 🐛 问题报告 / Bug Report
-description: 报告项目中的错误或问题 / Report bugs or issues in the project
-labels:
-  - "type: bug"
-  - "status: waiting-for-triage"
-type: Bug
-body:
-  - type: markdown
-    attributes:
-      value: |
-        ## 感谢您提交问题报告！/ Thank you for submitting a bug report!
-
-        请尽可能详细地描述问题，这将帮助我们更快地定位和修复问题。
-        Please describe the issue in as much detail as possible to help us locate and fix it faster.
-
-  - type: input
-    id: summary
-    attributes:
-      label: 问题摘要 / Issue Summary
-      description: 用一句话简要描述这个问题 / Briefly describe this bug in one sentence
-      placeholder: |
-        例如：执行某个操作后回调未触发
-        Example: Callback not triggered after executing a specific operation
-    validations:
-      required: true
-
-  - type: input
-    id: version
-    attributes:
-      label: 版本信息 / Version Information
-      description: 您使用的是哪个版本？/ Which version are you using?
-      placeholder: "例如 / e.g.: v1.0.0"
-    validations:
-      required: true
-
-  - type: input
-    id: runtime
-    attributes:
-      label: 运行环境 / Runtime Environment
-      description: 您使用的运行环境版本 / Your runtime environment version
-      placeholder: "例如 / e.g.: Node.js 20.x, Python 3.12, JDK 17"
-
-  - type: dropdown
-    id: os
-    attributes:
-      label: 操作系统 / Operating System
-      description: 您使用的操作系统 / Your operating system
-      options:
-        - "Windows 11"
-        - "Windows 10"
-        - "macOS (Intel)"
-        - "macOS (Apple Silicon)"
-        - "Ubuntu/Debian"
-        - "Other Linux"
-        - "其他 (请在下方说明) / Other (please specify below)"
-
-  - type: textarea
-    id: what-happened
-    attributes:
-      label: 发生了什么？/ What happened?
-      description: |
-        详细描述问题的现象
-        Describe the bug phenomenon in detail
-      placeholder: |
-        告诉我们您看到了什么！
-        Tell us what you saw!
-
-        例如 / Example:
-        - 执行某个操作后，未得到预期的结果
-        - After executing a specific operation, the expected result was not obtained
-    validations:
-      required: true
-
-  - type: textarea
-    id: expected
-    attributes:
-      label: 期望的行为 / Expected Behavior
-      description: |
-        描述您期望发生什么
-        Describe what you expected to happen
-      placeholder: |
-        告诉我们您期望看到什么！
-        Tell us what you expected to see!
-
-        例如 / Example:
-        - 操作应该成功完成并返回正确的结果
-        - The operation should complete successfully and return the correct result
-    validations:
-      required: true
-
-  - type: textarea
-    id: steps
-    attributes:
-      label: 重现步骤 / Steps to Reproduce
-      description: |
-        如何重现这个问题？
-        How to reproduce this issue?
-      placeholder: |
-        1. 安装依赖 / Install dependencies
-        2. 配置 '...' / Configure '...'
-        3. 运行 '...' / Run '...'
-        4. 看到错误 / See error
-    validations:
-      required: true
-
-  - type: textarea
-    id: logs
-    attributes:
-      label: 相关日志 / Relevant Logs
-      description: |
-        请复制粘贴任何相关的日志输出、错误信息或控制台输出
-        Please copy and paste any relevant log output, error messages, or console output
-
-        这将自动格式化为代码块，无需使用反引号
-        This will be automatically formatted as code block, no need for backticks
-      render: shell
-
-  - type: textarea
-    id: additional-context
-    attributes:
-      label: 额外信息 / Additional Context
-      description: |
-        添加任何其他有助于解决问题的信息，如截图、相关链接等
-        Add any other information that might help solve the issue, such as screenshots, related links, etc.
-
-  - type: checkboxes
-    id: terms
-    attributes:
-      label: 确认事项 / Confirmations
-      description: |
-        提交前请确认以下事项
-        Please confirm the following before submitting
-      options:
-        - label: |
-            我已经搜索了现有的issues，确认这不是重复问题
-            I have searched existing issues and confirmed this is not a duplicate
-          required: true
-        - label: |
-            我已经阅读了项目文档和 FAQ
-            I have read the project documentation and FAQ
-          required: true
-        - label: |
-            我提供的信息准确完整
-            The information I provided is accurate and complete
-          required: true
-        - label: |
-            我愿意协助测试问题修复 (可选)
-            I'm willing to help test the bug fix (optional)
-          required: false