@fitlab-ai/agent-infra 0.3.0

package/templates/.claude/CLAUDE.md

@@ -0,0 +1,163 @@
+# Project - Claude Code Instructions
+
+This repository uses agent-infra for multi-AI collaboration infrastructure.
+
+## Quick Commands
+
+<!-- TODO: Add your project's build commands here -->
+```bash
+# Install dependencies
+# TODO: your install command
+
+# Build
+# TODO: your build command
+
+# Run tests
+# TODO: your test command
+
+# Lint
+# TODO: your lint command
+```
+
+## Project Structure
+
+<!-- TODO: Add your project's directory structure here -->
+
+## Coding Standards
+
+<!-- TODO: Add your project's coding standards here -->
+
+### Copyright Header Update
+When modifying any file with a copyright header, update the year:
+1. Run `date +%Y` to get the current year (never hardcode)
+2. Update format: `2024-2025` -> `2024-2026` (assuming current year is 2026)
+
+### Branch Naming
+Use project prefix: `{{project}}-feature-xxx`, `{{project}}-bugfix-yyy`
+
+## Testing
+
+<!-- TODO: Add your project's test framework and commands here -->
+
+## Commit & PR Conventions
+
+### Commit Message Format (Conventional Commits)
+```
+<type>(<scope>): <subject>
+```
+- **type**: `feat`, `fix`, `docs`, `refactor`, `test`, `chore`
+- **scope**: module name (optional)
+- **subject**: English, imperative mood, max 50 characters
+
+### Claude commit signature
+```
+Co-Authored-By: Claude <noreply@anthropic.com>
+```
+
+### PR Checklist
+- [ ] Tests pass
+- [ ] Lint passes
+- [ ] Build succeeds
+- [ ] Public APIs documented
+- [ ] Copyright headers updated
+
+## Claude-Specific Rules
+
+### Critical Rules
+1. **No auto-commit**: Never execute `git commit`/`git add` automatically. Remind user to use `/commit`
+2. **Copyright year update**: Run `date +%Y`, use Edit tool to update
+3. **Task status management**: Update `task.md` fields after each command
+
+### Important Rules
+4. **Task semantic recognition**: Auto-detect user intent (e.g., "analyze issue 207" -> `/import-issue 207`; "analyze task TASK-20260306-143022" -> `/analyze-task TASK-20260306-143022`)
+5. **PR conventions**: Add generation marker when creating PRs
+
+**Detailed rules**: `.claude/project-rules.md`
+
+## Tool Usage
+
+| Operation | Recommended | Avoid |
+|-----------|-------------|-------|
+| File search | `Glob` | `find`, `ls` |
+| Content search | `Grep` | `grep`, `rg` |
+| Read files | `Read` | `cat`, `head`, `tail` |
+| Edit files | `Edit` | `sed`, `awk` |
+| Create files | `Write` | `echo >`, `cat <<EOF` |
+
+**Bash only for**: Git operations, build/test, system info
+
+## Slash Commands
+
+### Development
+```bash
+/commit [message]           # Commit code
+/create-pr [branch]         # Create PR
+```
+
+### Task Management
+```bash
+/create-task <description>  # Create task from description
+/import-issue <number>      # Import GitHub Issue as task
+/analyze-task <task-id>     # Analyze task requirements
+/plan-task <task-id>        # Design technical plan
+/implement-task <task-id>   # Implement task
+/review-task <task-id>      # Code review
+/complete-task <task-id>    # Complete task
+/check-task <task-id>       # Check status
+/block-task <task-id>       # Block task
+/refine-task <task-id>      # Handle review feedback
+```
+
+### PR and Sync
+```bash
+/sync-issue <number>        # Sync progress to Issue
+/sync-pr <number>           # Sync progress to PR
+```
+
+### Testing and Release
+```bash
+/test                       # Run tests
+/test-integration           # Run integration tests
+/release <version>          # Version release
+/create-release-note        # Generate release notes
+```
+
+### Security
+```bash
+/import-dependabot <number> # Import Dependabot alert
+/close-dependabot           # Close Dependabot alert
+/import-codescan <number>   # Import Code Scanning alert
+/close-codescan             # Close Code Scanning alert
+```
+
+### Tools
+```bash
+/init-milestones            # Initialize GitHub Milestones
+/init-labels                # Initialize GitHub Labels
+/refine-title               # Reformat Issue/PR title
+/upgrade-dependency         # Upgrade dependency
+/update-agent-infra  # Update AI collaboration config
+```
+
+## Language Conventions
+
+| Context | Language |
+|---------|----------|
+| Code identifiers, docs | English |
+| Git commit messages | English (Conventional Commits) |
+| Project documentation | English (primary) + Chinese translation |
+| AI responses | Follow user's input language |
+
+## Multi-AI Collaboration
+
+This project supports Claude Code, Codex, Gemini CLI, OpenCode.
+
+- `.agents/` - Shared collaboration config
+- `.agent-workspace/` - Task workspace (git-ignored)
+
+**Collaboration guide**: `.agents/README.md`
+
+## Security
+
+- Do not commit: `.env`, credentials, keys
+- Security issues: follow `SECURITY.md`

package/templates/.claude/CLAUDE.zh-CN.md

@@ -0,0 +1,163 @@
+# 项目 - Claude Code 指令
+
+本仓库使用 agent-infra 进行多 AI 协作基础设施管理。
+
+## 快速命令
+
+<!-- TODO: 在此添加你的项目构建命令 -->
+```bash
+# 安装依赖
+# TODO: 你的安装命令
+
+# 构建项目
+# TODO: 你的构建命令
+
+# 运行测试
+# TODO: 你的测试命令
+
+# 代码检查
+# TODO: 你的 lint 命令
+```
+
+## 项目结构
+
+<!-- TODO: 在此添加你的项目目录结构 -->
+
+## 编码规范
+
+<!-- TODO: 在此添加你的项目编码规范 -->
+
+### 版权头更新
+修改任意带版权头的文件时，必须更新版权年份：
+1. 先运行 `date +%Y` 获取当前年份（不要硬编码）
+2. 更新格式：`2024-2025` -> `2024-2026`（假设当前年份为 2026）
+
+### 分支命名
+使用项目前缀：`{{project}}-feature-xxx`、`{{project}}-bugfix-yyy`
+
+## 测试要求
+
+<!-- TODO: 在此添加你的项目测试框架和命令 -->
+
+## 提交与 PR 规范
+
+### 提交信息格式（Conventional Commits）
+```
+<type>(<scope>): <subject>
+```
+- **type**: `feat`, `fix`, `docs`, `refactor`, `test`, `chore`
+- **scope**: 模块名（可省略）
+- **subject**: 英文，简洁祈使语气，不超过 50 字符
+
+### Claude 提交署名
+```
+Co-Authored-By: Claude <noreply@anthropic.com>
+```
+
+### PR 检查清单
+- [ ] 测试通过
+- [ ] 代码检查通过
+- [ ] 构建成功
+- [ ] 公共 API 有文档
+- [ ] 版权头年份已更新
+
+## Claude 特定规则
+
+### 关键规则
+1. **禁止自动提交**：绝对不要自动执行 `git commit`/`git add`，提醒用户使用 `/commit`
+2. **版权年份更新**：运行 `date +%Y` 获取当前年份，使用 Edit 工具更新
+3. **任务状态管理**：执行命令后更新 `task.md` 字段
+
+### 重要规则
+4. **任务语义识别**：自动识别用户意图（如"分析 issue 207" -> `/import-issue 207`；"分析任务 TASK-20260306-143022" -> `/analyze-task TASK-20260306-143022`）
+5. **PR 规范**：创建 PR 时添加生成标记
+
+**详细规则**：`.claude/project-rules.md`
+
+## 工具使用偏好
+
+| 操作 | 推荐 | 不推荐 |
+|------|------|--------|
+| 文件搜索 | `Glob` | `find`、`ls` |
+| 内容搜索 | `Grep` | `grep`、`rg` |
+| 读取文件 | `Read` | `cat`、`head`、`tail` |
+| 编辑文件 | `Edit` | `sed`、`awk` |
+| 创建文件 | `Write` | `echo >`、`cat <<EOF` |
+
+**Bash 仅用于**：Git 操作、构建/测试、系统信息查询
+
+## Slash Commands
+
+### 开发相关
+```bash
+/commit [message]           # 提交代码
+/create-pr [branch]         # 创建 PR
+```
+
+### 任务管理
+```bash
+/create-task <description>  # 创建任务
+/import-issue <number>      # 导入 GitHub Issue 为任务
+/analyze-task <task-id>     # 分析任务需求
+/plan-task <task-id>        # 设计方案
+/implement-task <task-id>   # 实施任务
+/review-task <task-id>      # 代码审查
+/complete-task <task-id>    # 完成任务
+/check-task <task-id>       # 查看状态
+/block-task <task-id>       # 阻塞任务
+/refine-task <task-id>      # 处理审查反馈
+```
+
+### PR 与同步
+```bash
+/sync-issue <number>        # 同步进度到 Issue
+/sync-pr <number>           # 同步进度到 PR
+```
+
+### 测试与发布
+```bash
+/test                       # 运行测试
+/test-integration           # 运行集成测试
+/release <version>          # 版本发布
+/create-release-note        # 生成发布说明
+```
+
+### 安全
+```bash
+/import-dependabot <number> # 导入 Dependabot 告警
+/close-dependabot           # 关闭 Dependabot 告警
+/import-codescan <number>   # 导入 Code Scanning 告警
+/close-codescan             # 关闭 Code Scanning 告警
+```
+
+### 工具
+```bash
+/init-milestones            # 初始化 GitHub Milestones
+/init-labels                # 初始化 GitHub Labels
+/refine-title               # 重构 Issue/PR 标题
+/upgrade-dependency         # 升级依赖
+/update-agent-infra  # 更新 AI 协作配置
+```
+
+## 语言规范
+
+| 场景 | 语言 |
+|------|------|
+| 代码标识符、文档 | 英文 |
+| Git commit message | 英文 (Conventional Commits) |
+| 项目文档 | 英文（主） + 中文翻译 |
+| AI 回复 | 跟随用户输入语言 |
+
+## 多 AI 协作
+
+本项目支持 Claude Code、Codex、Gemini CLI、OpenCode。
+
+- `.agents/` - 共享协作配置
+- `.agent-workspace/` - 任务工作区（已被 git ignore）
+
+**协作指南**：`.agents/README.md`
+
+## 安全注意事项
+
+- 不要提交：`.env`、credentials、密钥
+- 安全问题请按 `SECURITY.md` 指引

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

@@ -0,0 +1,8 @@
+---
+description: "Analyze an existing task and output a requirement analysis document"
+usage: "/analyze-task <task-id>"
+---
+
+Read and execute the analyze-task skill from `.agents/skills/analyze-task/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "分析已有任务并输出需求分析文档，支持多轮分析产物。 当用户要求分析某个任务时触发。参数：task-id。"
+usage: "/analyze-task <task-id>"
+---
+
+读取并执行 `.agents/skills/analyze-task/SKILL.md` 中的 analyze-task 技能。
+
+严格按照技能中定义的所有步骤执行。

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

@@ -0,0 +1,8 @@
+---
+description: "Mark task as blocked and record blocking reason"
+usage: "/block-task <task-id> [reason]"
+---
+
+Read and execute the block-task skill from `.agents/skills/block-task/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "标记任务为阻塞状态并记录阻塞原因，将其从 active 目录移动到 blocked 目录。 当任务因技术问题、需求不清晰、缺少资源或待定决策而无法继续时使用。 参数：task-id，可选的阻塞原因。"
+usage: "/block-task <task-id> [reason]"
+---
+
+读取并执行 `.agents/skills/block-task/SKILL.md` 中的 block-task 技能。
+
+严格按照技能中定义的所有步骤执行。

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

@@ -0,0 +1,8 @@
+---
+description: "View task current status and progress"
+usage: "/check-task <task-id>"
+---
+
+Read and execute the check-task skill from `.agents/skills/check-task/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "查看任务的当前状态、工作流进度和上下文文件。这是只读操作，报告任务状态并建议 适当的下一步操作。当用户要求查看任务状态时触发。参数：task-id。"
+usage: "/check-task <task-id>"
+---
+
+读取并执行 `.agents/skills/check-task/SKILL.md` 中的 check-task 技能。
+
+严格按照技能中定义的所有步骤执行。

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

@@ -0,0 +1,8 @@
+---
+description: "Close Code Scanning alert with documented reason"
+usage: "/close-codescan <alert-number>"
+---
+
+Read and execute the close-codescan skill from `.agents/skills/close-codescan/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "关闭 Code Scanning（CodeQL）告警并提供有据可查的理由。 当用户要求关闭 Code Scanning 告警时触发。参数：告警编号。"
+usage: "/close-codescan <alert-number>"
+---
+
+读取并执行 `.agents/skills/close-codescan/SKILL.md` 中的 close-codescan 技能。
+
+严格按照技能中定义的所有步骤执行。

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

@@ -0,0 +1,8 @@
+---
+description: "Close Dependabot security alert with documented reason"
+usage: "/close-dependabot <alert-number>"
+---
+
+Read and execute the close-dependabot skill from `.agents/skills/close-dependabot/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "关闭 Dependabot 安全告警并提供有据可查的理由。 当用户要求关闭 Dependabot 告警时触发。参数：告警编号。"
+usage: "/close-dependabot <alert-number>"
+---
+
+读取并执行 `.agents/skills/close-dependabot/SKILL.md` 中的 close-dependabot 技能。
+
+严格按照技能中定义的所有步骤执行。

package/templates/.claude/commands/commit.md

@@ -0,0 +1,7 @@
+---
+description: "Commit current changes to Git"
+---
+
+Read and execute the commit skill from `.agents/skills/commit/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,7 @@
+---
+description: "提交当前变更到 Git，包含版权头年份检查和任务状态更新。 当用户要求提交代码或保存变更时触发。"
+---
+
+读取并执行 `.agents/skills/commit/SKILL.md` 中的 commit 技能。
+
+严格按照技能中定义的所有步骤执行。

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

@@ -0,0 +1,8 @@
+---
+description: "Mark task completed and archive to completed directory"
+usage: "/complete-task <task-id>"
+---
+
+Read and execute the complete-task skill from `.agents/skills/complete-task/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "标记任务完成并归档，将任务目录从 active/ 移动到 completed/。在允许完成之前， 验证所有工作流步骤已完成、代码已审查并提交、测试已通过。 当用户要求完成或归档任务时触发。参数：task-id。"
+usage: "/complete-task <task-id>"
+---
+
+读取并执行 `.agents/skills/complete-task/SKILL.md` 中的 complete-task 技能。
+
+严格按照技能中定义的所有步骤执行。

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

@@ -0,0 +1,8 @@
+---
+description: "Create Pull Request to specified or auto-detected target branch"
+usage: "/create-pr [target-branch]"
+---
+
+Read and execute the create-pr skill from `.agents/skills/create-pr/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "创建 Pull Request 到指定或自动推断的目标分支。 当用户要求创建 PR 时触发。可选参数：目标分支。"
+usage: "/create-pr [target-branch]"
+---
+
+读取并执行 `.agents/skills/create-pr/SKILL.md` 中的 create-pr 技能。
+
+严格按照技能中定义的所有步骤执行。

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

@@ -0,0 +1,8 @@
+---
+description: "Auto-generate structured Release Notes from PR/commit and optionally create GitHub Draft Release"
+usage: "/create-release-note <ver> [prev]"
+---
+
+Read and execute the create-release-note skill from `.agents/skills/create-release-note/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "从 PR 和 commit 生成版本发布说明。 当用户要求生成发布说明时触发。参数：版本号，可选的上一版本号。"
+usage: "/create-release-note <ver> [prev]"
+---
+
+读取并执行 `.agents/skills/create-release-note/SKILL.md` 中的 create-release-note 技能。
+
+严格按照技能中定义的所有步骤执行。

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

@@ -0,0 +1,8 @@
+---
+description: "Create task from natural language description and generate requirement analysis document"
+usage: "/create-task <description>"
+---
+
+Read and execute the create-task skill from `.agents/skills/create-task/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "根据用户的自然语言描述创建任务并执行需求分析。当用户描述一个新功能、Bug 或改进需求时触发。 唯一的产出是 task.md 和 analysis.md —— 不编写任何业务代码。参数：任务描述文本。"
+usage: "/create-task <description>"
+---
+
+读取并执行 `.agents/skills/create-task/SKILL.md` 中的 create-task 技能。
+
+严格按照技能中定义的所有步骤执行。

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

@@ -0,0 +1,8 @@
+---
+description: "Implement task based on technical plan and output implementation report"
+usage: "/implement-task <task-id>"
+---
+
+Read and execute the implement-task skill from `.agents/skills/implement-task/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "根据技术方案实施任务，编写代码和测试，输出实现报告。当用户在技术方案审查通过后要求实施任务或编码时触发。 参数：task-id。"
+usage: "/implement-task <task-id>"
+---
+
+读取并执行 `.agents/skills/implement-task/SKILL.md` 中的 implement-task 技能。
+
+严格按照技能中定义的所有步骤执行。

package/templates/.claude/commands/import-codescan.md

@@ -0,0 +1,8 @@
+---
+description: "Import a Code Scanning alert and create a remediation task"
+usage: "/import-codescan <alert-number>"
+---
+
+Read and execute the import-codescan skill from `.agents/skills/import-codescan/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "导入 Code Scanning（CodeQL）告警并创建修复任务。 当用户要求导入 Code Scanning 告警时触发。参数：告警编号。"
+usage: "/import-codescan <alert-number>"
+---
+
+读取并执行 `.agents/skills/import-codescan/SKILL.md` 中的 import-codescan 技能。
+
+严格按照技能中定义的所有步骤执行。

package/templates/.claude/commands/import-dependabot.md

@@ -0,0 +1,8 @@
+---
+description: "Import a Dependabot alert and create a remediation task"
+usage: "/import-dependabot <alert-number>"
+---
+
+Read and execute the import-dependabot skill from `.agents/skills/import-dependabot/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "导入 Dependabot 安全告警并创建修复任务。 当用户要求导入 Dependabot 告警时触发。参数：告警编号。"
+usage: "/import-dependabot <alert-number>"
+---
+
+读取并执行 `.agents/skills/import-dependabot/SKILL.md` 中的 import-dependabot 技能。
+
+严格按照技能中定义的所有步骤执行。

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

@@ -0,0 +1,8 @@
+---
+description: "Import a GitHub Issue and create a task file"
+usage: "/import-issue <issue-number>"
+---
+
+Read and execute the import-issue skill from `.agents/skills/import-issue/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "从 GitHub Issue 导入并创建任务文件。 当用户要求导入某个 Issue 时触发。参数：issue 编号。"
+usage: "/import-issue <issue-number>"
+---
+
+读取并执行 `.agents/skills/import-issue/SKILL.md` 中的 import-issue 技能。
+
+严格按照技能中定义的所有步骤执行。

package/templates/.claude/commands/init-labels.md

@@ -0,0 +1,7 @@
+---
+description: "Initialize the repository's standard GitHub Labels taxonomy"
+---
+
+Read and execute the init-labels skill from `.agents/skills/init-labels/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,7 @@
+---
+description: "一次性初始化仓库的标准 GitHub Labels 体系。创建通用 labels、自动探测 in: labels、不生成 theme: labels，并提示未覆盖的默认 labels。"
+---
+
+读取并执行 `.agents/skills/init-labels/SKILL.md` 中的 init-labels 技能。
+
+严格按照技能中定义的所有步骤执行。

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

@@ -0,0 +1,8 @@
+---
+description: "Initialize the repository's standard GitHub Milestones taxonomy and optionally backfill historical milestones with --history"
+usage: "/init-milestones [--history]"
+---
+
+Read and execute the init-milestones skill from `.agents/skills/init-milestones/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "一次性初始化仓库的标准 GitHub Milestones 体系。创建 General Backlog、基于当前版本的初始里程碑，并可选通过 --history 补齐历史版本里程碑。"
+usage: "/init-milestones [--history]"
+---
+
+读取并执行 `.agents/skills/init-milestones/SKILL.md` 中的 init-milestones 技能。
+
+严格按照技能中定义的所有步骤执行。

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

@@ -0,0 +1,8 @@
+---
+description: "Design technical solution and output implementation plan"
+usage: "/plan-task <task-id>"
+---
+
+Read and execute the plan-task skill from `.agents/skills/plan-task/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

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

@@ -0,0 +1,8 @@
+---
+description: "为任务设计技术方案并输出详细的实施计划。当用户要求为已完成需求分析的任务设计方案或技术计划时触发。 这是一个强制性的人工审查检查点。参数：task-id。"
+usage: "/plan-task <task-id>"
+---
+
+读取并执行 `.agents/skills/plan-task/SKILL.md` 中的 plan-task 技能。
+
+严格按照技能中定义的所有步骤执行。

package/templates/.claude/commands/refine-task.md

@@ -0,0 +1,8 @@
+---
+description: "Handle code review feedback and fix issues"
+usage: "/refine-task <task-id>"
+---
+
+Read and execute the refine-task skill from `.agents/skills/refine-task/SKILL.md`.
+
+Follow all steps defined in the skill exactly.