@fitlab-ai/agent-infra 0.4.1 → 0.4.3

package/templates/.opencode/COMMAND_STYLE_GUIDE.zh-CN.md

@@ -1,232 +0,0 @@
-# 命令编写风格指南
-
-本指南定义了 `.opencode/commands/` 目录中 OpenCode 命令文件的编写规范。
-
-## 文件格式
-
-每个命令文件使用带 YAML 前置元数据的 Markdown 格式：
-
-```markdown
----
-description: 简要描述
-agent: general
-subtask: false
----
-
-命令指令内容。
-```
-
-### 前置元数据字段
-
-| 字段 | 必需 | 说明 |
-|------|------|------|
-| `description` | 是 | 一行摘要（80 字符以内） |
-| `agent` | 是 | 除非有专门代理，否则为 `general` |
-| `subtask` | 是 | 顶层命令为 `false` |
-
-## 可执行命令 vs 代码块
-
-### 使用 `!` 前缀标记必须执行的命令
-
-```markdown
-!date -u +"%Y-%m-%dT%H:%M:%SZ"
-!git status --short
-!gh issue view 123 --json number,title,body
-```
-
-`!` 前缀告诉 OpenCode 直接运行该命令。适用于：
-- 获取动态信息（时间戳、git 状态）
-- 执行操作（创建文件、调用 API）
-- 运行构建/测试命令
-
-### 使用 markdown 代码块展示说明性示例
-
-````markdown
-预期输出格式：
-```
-Task ID: TASK-20260101-120000
-Status: active
-```
-````
-
-代码块不会被执行。适用于：
-- 展示预期输出格式
-- 记录模板
-- 说明 AI 应遵循的模式
-
-## 参数处理
-
-### 位置参数
-
-通过 `$ARGUMENTS` 引用：
-
-```markdown
-从 `$ARGUMENTS` 中解析任务 ID。
-```
-
-### 验证
-
-始终在早期验证必需参数：
-
-```markdown
-如果 `$ARGUMENTS` 为空，回复：
-"请提供任务 ID。示例：/check-task TASK-20260101-120000"
-然后 STOP。
-```
-
-## 时间戳处理
-
-**绝对不要**硬编码日期或年份。
-
-正确做法：
-```markdown
-!date -u +"%Y-%m-%dT%H:%M:%SZ"
-```
-
-错误做法：
-```markdown
-将日期设为 2026-03-06。
-```
-
-## GitHub API 路径
-
-**始终**使用 `{owner}/{repo}` 占位符。动态解析：
-
-```markdown
-!gh api repos/{owner}/{repo}/dependabot/alerts/$ARGUMENTS
-```
-
-获取 owner/repo：
-```markdown
-!gh repo view --json owner,name -q '.owner.login + "/" + .name'
-```
-
-## 步骤编号和可读性
-
-### 使用编号标记顺序操作
-
-```markdown
-## 步骤
-
-1. **验证输入** - 检查是否提供了任务 ID。
-
-2. **读取任务文件** - 查找并读取 task.md 文件。
-
-3. **更新状态** - 修改任务元数据。
-```
-
-### 使用粗体标记步骤标题
-
-每个步骤应有清晰的粗体标题，后跟描述。
-
-### 保持步骤原子化
-
-每个步骤只做一件事。如果步骤太复杂，拆分为子步骤。
-
-## 错误处理模式
-
-### 在操作前检查前置条件
-
-```markdown
-1. **验证任务存在**
-
-按以下顺序搜索任务文件：
-- `.agents/workspace/active/{task-id}/task.md`
-- `.agents/workspace/blocked/{task-id}/task.md`
-- `.agents/workspace/completed/{task-id}/task.md`
-
-如果未找到，回复：
-"任务 {task-id} 不存在，请检查任务 ID。"
-然后 STOP。
-```
-
-### 清晰地报告错误
-
-```markdown
-如果命令失败，报告：
-- 出了什么问题
-- 可能的原因
-- 建议的后续步骤
-
-不要静默继续。
-```
-
-## 常见模式
-
-### 任务文件查找模式
-
-```markdown
-按以下顺序搜索任务：
-1. `.agents/workspace/active/{task-id}/task.md`
-2. `.agents/workspace/blocked/{task-id}/task.md`
-3. `.agents/workspace/completed/{task-id}/task.md`
-```
-
-### 状态更新模式
-
-```markdown
-更新 `task.md` YAML 前置元数据：
-- `current_step`: {步骤名}
-- `assigned_to`: opencode
-- `updated_at`: {通过 date 命令获取的当前时间戳}
-```
-
-### 下一步建议模式
-
-```markdown
-**下一步：**
-使用 `/plan-task {task-id}` 设计技术方案。
-```
-
-## 反模式
-
-### 不要
-
-- 硬编码日期、年份或时间戳
-- 在 API 路径中硬编码仓库 owner/name
-- 跳过参数验证
-- 未经用户确认就自动提交
-- 使用特定工具语法（如 Claude 的 Read/Edit/Write 工具名）
-- 引用特定技术栈的命令但不加 TODO 标记
-- 在命令文件中使用 emoji（保持专业）
-- 写过长的步骤——应该拆分
-
-### 要
-
-- 对所有可执行命令使用 `!` 前缀
-- 在继续之前验证参数
-- 提供清晰的错误消息
-- 在错误条件后包含 "STOP"
-- 保持命令简洁且易于浏览
-- 对项目特定的值使用占位符
-- 对技术栈特定的部分添加 TODO 标记
-
-## 技术栈无关的命令
-
-对于依赖项目技术栈的命令（构建工具、测试运行器、包管理器），使用 TODO 标记：
-
-```markdown
-3. **运行测试**
-
-<!-- TODO: Replace with your project's test command -->
-!npm test
-```
-
-这告诉用户需要根据自己的项目定制该命令。
-
-## 命令审查清单
-
-提交新命令前，请验证：
-
-- [ ] 前置元数据包含 `description`、`agent` 和 `subtask`
-- [ ] 所有可执行命令使用 `!` 前缀
-- [ ] 所有说明性示例使用代码块（无 `!`）
-- [ ] 参数已验证，有清晰的错误消息
-- [ ] 时间戳动态生成
-- [ ] GitHub API 路径使用 `{owner}/{repo}` 占位符
-- [ ] 步骤已编号且有粗体标题
-- [ ] 错误情况使用 "STOP" 指令处理
-- [ ] 无硬编码的日期、仓库名或工具特定引用
-- [ ] 技术栈特定的部分有 TODO 标记
-- [ ] 已创建英文和中文两个版本
-- [ ] 命令简洁——无多余的描述

package/templates/.opencode/README.md

@@ -1,76 +0,0 @@
-# OpenCode Commands
-
-This directory contains command files for [OpenCode](https://opencode.ai), an AI-powered coding assistant.
-
-## Structure
-
-```
-.opencode/
-  README.md                          # This file
-  COMMAND_STYLE_GUIDE.md             # Guide for writing commands
-  commands/
-    {command}.md                     # English command files
-    {command}.zh-CN.md               # Chinese command files
-```
-
-## Command Format
-
-Each command file uses Markdown with YAML frontmatter:
-
-```markdown
----
-description: Brief description of what the command does
-agent: general
-subtask: false
----
-
-Step-by-step instructions for the AI agent.
-Use `!` prefix for shell commands that should be executed directly.
-Use markdown code blocks for illustrative examples that should NOT be auto-executed.
-```
-
-## Available Commands
-
-### Project Setup
-- `update-agent-infra` - Update project configuration
-
-### Development
-- `commit` - Commit current changes to Git
-- `test` - Run unit tests (TODO: tech-stack specific)
-- `test-integration` - Run integration tests (TODO: tech-stack specific)
-
-### Task Management
-- `create-task` - Create a task from natural language description
-- `import-issue` - Import a GitHub Issue as a task
-- `analyze-task` - Analyze task requirements
-- `plan-task` - Design a technical plan for a task
-- `implement-task` - Implement a task based on the plan
-- `review-task` - Review task implementation
-- `refine-task` - Address review feedback
-- `complete-task` - Mark task as completed and archive
-- `check-task` - Check task status
-- `block-task` - Mark task as blocked
-
-### Pull Requests and Sync
-- `create-pr` - Create a Pull Request
-- `sync-pr` - Sync task progress to PR comments
-- `sync-issue` - Sync task progress to Issue comments
-
-### Security
-- `import-dependabot` - Import Dependabot alerts
-- `close-dependabot` - Close Dependabot alerts
-- `import-codescan` - Import Code Scanning alerts
-- `close-codescan` - Close Code Scanning alerts
-
-### Release and Maintenance
-- `release` - Create a release (TODO: tech-stack specific)
-- `create-release-note` - Generate release notes
-- `refine-title` - Refine Issue/PR titles
-- `upgrade-dependency` - Upgrade a dependency (TODO: tech-stack specific)
-
-## Conventions
-
-- Commands are **tool-agnostic** and **tech-stack agnostic**
-- Commands with `TODO` markers require project-specific customization
-- All timestamps are generated dynamically (never hardcoded)
-- GitHub API paths use `{owner}/{repo}` placeholders

package/templates/.opencode/README.zh-CN.md

@@ -1,77 +0,0 @@
-# OpenCode 命令
-
-本目录包含 [OpenCode](https://opencode.ai) AI 编码助手的命令文件。
-
-## 目录结构
-
-```
-.opencode/
-  README.md                          # 英文说明
-  README.zh-CN.md                    # 本文件
-  COMMAND_STYLE_GUIDE.md             # 命令编写指南
-  commands/
-    {command}.md                     # 英文命令文件
-    {command}.zh-CN.md               # 中文命令文件
-```
-
-## 命令格式
-
-每个命令文件使用带 YAML 前置元数据的 Markdown 格式：
-
-```markdown
----
-description: 命令功能的简要描述
-agent: general
-subtask: false
----
-
-AI 代理的分步指令。
-使用 `!` 前缀标记需要直接执行的 shell 命令。
-使用 markdown 代码块展示不需要自动执行的示例。
-```
-
-## 可用命令
-
-### 项目设置
-- `update-agent-infra` - 更新项目配置
-
-### 开发
-- `commit` - 提交当前变更到 Git
-- `test` - 运行单元测试（TODO: 需适配技术栈）
-- `test-integration` - 运行集成测试（TODO: 需适配技术栈）
-
-### 任务管理
-- `create-task` - 从自然语言描述创建任务
-- `import-issue` - 导入 GitHub Issue 为任务
-- `analyze-task` - 分析任务需求
-- `plan-task` - 为任务设计技术方案
-- `implement-task` - 根据方案实施任务
-- `review-task` - 审查任务实现
-- `refine-task` - 处理审查反馈
-- `complete-task` - 标记任务完成并归档
-- `check-task` - 查看任务状态
-- `block-task` - 标记任务为阻塞
-
-### PR 和同步
-- `create-pr` - 创建 Pull Request
-- `sync-pr` - 同步任务进度到 PR 评论
-- `sync-issue` - 同步任务进度到 Issue 评论
-
-### 安全
-- `import-dependabot` - 导入 Dependabot 告警
-- `close-dependabot` - 关闭 Dependabot 告警
-- `import-codescan` - 导入 Code Scanning 告警
-- `close-codescan` - 关闭 Code Scanning 告警
-
-### 发布和维护
-- `release` - 创建发布版本（TODO: 需适配技术栈）
-- `create-release-note` - 生成发布说明
-- `refine-title` - 优化 Issue/PR 标题
-- `upgrade-dependency` - 升级依赖（TODO: 需适配技术栈）
-
-## 约定
-
-- 命令是**工具无关**和**技术栈无关**的
-- 带 `TODO` 标记的命令需要根据项目具体技术栈进行定制
-- 所有时间戳动态生成（禁止硬编码）
-- GitHub API 路径使用 `{owner}/{repo}` 占位符

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

@@ -1,11 +0,0 @@
----
-description: "Sync task progress to a GitHub Issue"
-agent: general
-subtask: false
----
-
-Sync task $1 to Issue.
-
-Read and execute the sync-issue skill from `.agents/skills/sync-issue/SKILL.md`.
-
-Follow all steps defined in the skill exactly.

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

@@ -1,11 +0,0 @@
----
-description: "将任务进度同步到 GitHub Issue"
-agent: general
-subtask: false
----
-
-同步任务 $1 到 Issue。
-
-读取并执行 `.agents/skills/sync-issue/SKILL.md` 中的 sync-issue 技能。
-
-严格按照技能中定义的所有步骤执行。

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

@@ -1,11 +0,0 @@
----
-description: "Sync task progress to a Pull Request"
-agent: general
-subtask: false
----
-
-Sync task $1 to PR.
-
-Read and execute the sync-pr skill from `.agents/skills/sync-pr/SKILL.md`.
-
-Follow all steps defined in the skill exactly.

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

@@ -1,11 +0,0 @@
----
-description: "将任务进度同步到 Pull Request"
-agent: general
-subtask: false
----
-
-同步任务 $1 到 PR。
-
-读取并执行 `.agents/skills/sync-pr/SKILL.md` 中的 sync-pr 技能。
-
-严格按照技能中定义的所有步骤执行。

package/templates/AGENTS.md

@@ -1,112 +0,0 @@
-# agent-infra - AI Development Guide
-
-This repository contains the agent-infra template and skill repository for multi-AI collaboration infrastructure.
-
-## Quick Start Commands
-
-<!-- TODO: Add your project's build commands here -->
-```bash
-# Example (replace with your project's commands):
-# npm install / mvn clean install / pip install -r requirements.txt
-# npm run build / mvn package / make build
-# npm test / mvn test / pytest
-# npm run lint / mvn checkstyle:check / flake8
-```
-
-## Coding Standards (Required)
-
-<!-- TODO: Add your project's coding standards here -->
-
-### Copyright Header Update Rules
-When modifying any file with a copyright header, you must update the copyright year:
-1. Run `date +%Y` to get the current year (never hardcode)
-2. Update format example (assuming current year is 2026):
-   - `2024-2025` -> `2024-2026`
-   - `2024` -> `2024-2026`
-
-### Branch Naming
-Use project prefix: `{{project}}-feature-xxx`, `{{project}}-bugfix-yyy`
-
-## Project Structure
-
-<!-- TODO: Add your project's directory structure here -->
-
-## Testing Requirements
-
-<!-- TODO: Add your project's test framework and commands here -->
-
-## Commit and PR Conventions
-
-### Commit Message Format (Conventional Commits)
-```
-<type>(<scope>): <subject>
-
-Examples:
-feat(module): add new feature
-fix(module): fix critical bug
-docs(module): update documentation
-refactor(module): refactor internal logic
-```
-
-- **type**: `feat`, `fix`, `docs`, `refactor`, `test`, `chore`
-- **scope**: module name (optional)
-- **subject**: English, imperative mood, max 50 characters
-
-### PR Checklist
-Before submitting a PR, ensure:
-- [ ] All tests pass
-- [ ] Lint checks pass
-- [ ] Build succeeds
-- [ ] Public APIs have documentation
-- [ ] Copyright headers updated (if applicable)
-
-## Security Notes
-
-- Do not commit sensitive files: `.env`, `credentials.json`, keys, etc.
-- Handle security issues privately according to your project's disclosure policy (do not open public Issues)
-
-## Multi-AI Collaboration Support
-
-This project supports Claude Code, Codex, Gemini CLI, OpenCode and other AI tools working together.
-
-**Collaboration config directory**:
-- `.agents/` - AI configuration and workflow definitions (version controlled)
-
-**Language conventions**:
-
-All code-level content uses **English**. Documentation provides **multilingual versions** (English as primary).
-
-| Context | Language | Notes |
-|---------|----------|-------|
-| Code identifiers, JSDoc/TSDoc | English | Code is documentation |
-| CLI help text, error messages | English | For all users |
-| Git commit messages | English | Conventional Commits imperative mood |
-| Project documentation | English (primary) + Chinese translation | e.g. `README.md` + `README.zh-CN.md` |
-| AI responses | Follow user's input language | Chinese question -> Chinese answer |
-
-<!-- TODO: Add your project's tech stack here -->
-
-## Skill Authoring Conventions
-
-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 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 -->
-
----
-
-**Based on standard**: [AGENTS.md](https://agents.md) (Linux Foundation AAIF)

package/templates/AGENTS.zh-CN.md

@@ -1,112 +0,0 @@
-# agent-infra - AI 开发指南
-
-本仓库包含 agent-infra 模板和技能仓库，用于多 AI 协作基础设施。
-
-## 快速开始命令
-
-<!-- TODO: 在此添加你的项目构建命令 -->
-```bash
-# 示例（替换为你的项目命令）：
-# npm install / mvn clean install / pip install -r requirements.txt
-# npm run build / mvn package / make build
-# npm test / mvn test / pytest
-# npm run lint / mvn checkstyle:check / flake8
-```
-
-## 编码规范（必须遵守）
-
-<!-- TODO: 在此添加你的项目编码规范 -->
-
-### 版权头更新规则
-修改任意带版权头的文件时，必须更新版权年份：
-1. 先运行 `date +%Y` 获取当前年份（不要硬编码）
-2. 更新格式示例（假设当前年份为 2026）：
-   - `2024-2025` -> `2024-2026`
-   - `2024` -> `2024-2026`
-
-### 分支命名
-使用项目前缀：`{{project}}-feature-xxx`、`{{project}}-bugfix-yyy`
-
-## 项目结构
-
-<!-- TODO: 在此添加你的项目目录结构 -->
-
-## 测试要求
-
-<!-- TODO: 在此添加你的项目测试框架和命令 -->
-
-## 提交与 PR 规范
-
-### 提交信息格式（Conventional Commits）
-```
-<type>(<scope>): <subject>
-
-示例：
-feat(module): add new feature
-fix(module): fix critical bug
-docs(module): update documentation
-refactor(module): refactor internal logic
-```
-
-- **type**: `feat`, `fix`, `docs`, `refactor`, `test`, `chore`
-- **scope**: 模块名（可省略）
-- **subject**: 英文，简洁祈使语气，不超过 50 字符
-
-### PR 检查清单
-提交 PR 前必须确保：
-- [ ] 所有测试通过
-- [ ] 代码检查通过
-- [ ] 构建成功
-- [ ] 公共 API 有文档
-- [ ] 版权头年份已更新（如适用）
-
-## 安全注意事项
-
-- 不要提交敏感文件：`.env`, `credentials.json`, 密钥等
-- 安全问题请按项目自己的披露流程私下处理（不要公开 Issue）
-
-## 多 AI 协作支持
-
-本项目支持 Claude Code、Codex、Gemini CLI、OpenCode 等多个 AI 工具协同工作。
-
-**协作配置目录**：
-- `.agents/` - AI 配置和工作流定义（版本控制）
-
-**语言规范**：
-
-项目代码层面统一使用**英文**，文档提供**多语言版本**（英文为主版本）。
-
-| 场景 | 语言 | 说明 |
-|------|------|------|
-| 代码标识符、JSDoc/TSDoc | 英文 | 代码即文档 |
-| CLI 帮助文本、错误信息 | 英文 | 面向所有用户 |
-| Git commit message | 英文 | Conventional Commits 祈使语气 |
-| 项目文档 | 英文（主） + 中文翻译 | 如 `README.md` + `README.zh-CN.md` |
-| AI 回复 | 跟随用户输入语言 | 中文问→中文答 |
-
-<!-- TODO: 在此添加你的项目技术栈 -->
-
-## Skill 编写规范
-
-编写或维护 `.agents/skills/*/SKILL.md` 及其模板时，步骤编号遵循以下规则：
-
-1. 顶级步骤使用连续整数：`1.`、`2.`、`3.`。
-2. 只有父步骤下的从属动作才使用子步骤：`1.1`、`1.2`、`2.1`。
-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 -->
-
----
-
-**基于标准**: [AGENTS.md](https://agents.md) (Linux Foundation AAIF)