@fitlab-ai/agent-infra 0.3.1 → 0.4.0

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

@@ -131,9 +131,9 @@ Status: active
 1. **验证任务存在**
 
 按以下顺序搜索任务文件：
-- `.agent-workspace/active/{task-id}/task.md`
-- `.agent-workspace/blocked/{task-id}/task.md`
-- `.agent-workspace/completed/{task-id}/task.md`
+- `.agents/workspace/active/{task-id}/task.md`
+- `.agents/workspace/blocked/{task-id}/task.md`
+- `.agents/workspace/completed/{task-id}/task.md`
 
 如果未找到，回复：
 "任务 {task-id} 不存在，请检查任务 ID。"
@@ -157,9 +157,9 @@ Status: active
 
 ```markdown
 按以下顺序搜索任务：
-1. `.agent-workspace/active/{task-id}/task.md`
-2. `.agent-workspace/blocked/{task-id}/task.md`
-3. `.agent-workspace/completed/{task-id}/task.md`
+1. `.agents/workspace/active/{task-id}/task.md`
+2. `.agents/workspace/blocked/{task-id}/task.md`
+3. `.agents/workspace/completed/{task-id}/task.md`
 ```
 
 ### 状态更新模式

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
 
@@ -86,6 +86,19 @@ All code-level content uses **English**. Documentation provides **multilingual v
 
 <!-- TODO: Add your project's tech stack here -->
 
+## Skill Authoring Conventions
+
+When writing or updating `.agents/skills/*/SKILL.md` files, 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.
+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.
+
+<!-- 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

@@ -63,7 +63,7 @@ refactor(module): refactor internal logic
 ## 安全注意事项
 
 - 不要提交敏感文件：`.env`, `credentials.json`, 密钥等
-- 安全问题请按 `SECURITY.md` 指引私下提交（不要公开 Issue）
+- 安全问题请按项目自己的披露流程私下处理（不要公开 Issue）
 
 ## 多 AI 协作支持
 
@@ -86,6 +86,19 @@ refactor(module): refactor internal logic
 
 <!-- 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`）和对脚本职责的概要说明。
+
+<!-- Canonical source: .agents/README.zh-CN.md - keep in sync -->
+
 ---
 
 **基于标准**: [AGENTS.md](https://agents.md) (Linux Foundation AAIF)

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

package/templates/.github/ISSUE_TEMPLATE/02_question.yml

@@ -1,101 +0,0 @@
-name: ❓ 问题咨询 / Question
-description: 询问使用相关的问题 / Ask usage-related questions
-labels:
-  - "type: question"
-  - "status: waiting-for-triage"
-type: Task
-body:
-  - type: markdown
-    attributes:
-      value: |
-        ## 提问前请先查看 / Please check before asking
-
-        - 📚 项目文档 / Documentation
-        - ❓ 常见问题 / FAQ
-        如果文档中没有找到答案，请详细描述您的问题。
-        If you can't find the answer in the documentation, please describe your question in detail.
-
-  - type: input
-    id: summary
-    attributes:
-      label: 问题摘要 / Question Summary
-      description: |
-        简要描述您的问题
-        Briefly describe your question
-      placeholder: |
-        例如：如何正确配置项目？
-        Example: How to configure the project correctly?
-    validations:
-      required: true
-
-  - type: dropdown
-    id: category
-    attributes:
-      label: 问题类别 / Question Category
-      description: |
-        您的问题属于哪个类别？
-        Which category does your question belong to?
-      options:
-        - 安装配置 / Installation & Configuration
-        - 使用教程 / Usage Tutorial
-        - "API相关 / API Related"
-        - 故障排除 / Troubleshooting
-        - 最佳实践 / Best Practices
-        - 性能相关 / Performance Related
-        - 集成问题 / Integration Issues
-        - 其他 / Other
-    validations:
-      required: true
-
-  - type: textarea
-    id: question
-    attributes:
-      label: 详细问题 / Detailed Question
-      description: |
-        详细描述您遇到的问题，包括：
-        - 您想要实现什么
-        - 您尝试了什么方法
-        - 遇到了什么困难
-
-        Describe your problem in detail, including:
-        - What you want to achieve
-        - What methods you tried
-        - What difficulties you encountered
-      placeholder: |
-        我想要... / I want to...
-        我尝试了... / I tried...
-        但是遇到了... / But I encountered...
-    validations:
-      required: true
-
-  - type: textarea
-    id: context
-    attributes:
-      label: 环境信息 / Environment Information
-      description: |
-        提供相关的环境信息 / Provide relevant environment information
-      placeholder: |
-        - 操作系统 / OS: (例如 Windows 11, macOS 13, Ubuntu 20.04)
-        - 运行环境版本 / Runtime Version: (例如 Node.js v20.11.0)
-        - 项目版本 / Project Version: (例如 v0.1.0)
-        - 其他相关信息 / Other relevant info:
-
-  - type: checkboxes
-    id: checklist
-    attributes:
-      label: 确认事项 / Checklist
-      description: |
-        提交前请确认 / Please confirm before submitting
-      options:
-        - label: |
-            我已经查看了项目文档
-            I have read the project documentation
-          required: true
-        - label: |
-            我已经搜索了相关 issues 和讨论
-            I have searched related issues and discussions
-          required: true
-        - label: |
-            我已经尝试了基本的故障排除步骤
-            I have tried basic troubleshooting steps
-          required: true

package/templates/.github/ISSUE_TEMPLATE/03_feature_request.yml

@@ -1,131 +0,0 @@
-name: ✨ 功能请求 / Feature Request
-description: 建议一个新功能或改进 / Suggest a new feature or improvement
-labels:
-  - "type: feature"
-  - "status: waiting-for-internal-feedback"
-type: Feature
-body:
-  - type: markdown
-    attributes:
-      value: |
-        ## 感谢您的功能建议！/ Thank you for your feature suggestion!
-
-        请详细描述您的想法，这将帮助我们更好地理解和评估您的建议。
-        Please describe your idea in detail to help us better understand and evaluate your suggestion.
-
-  - type: input
-    id: summary
-    attributes:
-      label: 功能摘要 / Feature Summary
-      description: |
-        用一句话描述您想要的功能
-        Describe the feature you want in one sentence
-      placeholder: |
-        例如：支持自动检测并应用最佳配置
-        Example: Support automatic detection and application of optimal configuration
-    validations:
-      required: true
-
-  - type: dropdown
-    id: feature-type
-    attributes:
-      label: 功能类型 / Feature Type
-      description: |
-        这是什么类型的功能请求？
-        What type of feature request is this?
-      options:
-        - 全新功能 / New Feature
-        - 用户体验改进 / UX Improvement
-        - 性能优化 / Performance Optimization
-        - "API改进 / API Enhancement"
-        - 文档改进 / Documentation Improvement
-        - 安全性增强 / Security Enhancement
-        - 工具集成 / Tooling Integration
-        - 其他 / Other
-    validations:
-      required: true
-
-  - type: dropdown
-    id: priority
-    attributes:
-      label: 优先级 / Priority
-      description: |
-        您认为这个功能的重要程度如何？
-        How important do you think this feature is?
-      options:
-        - 高 - 非常需要这个功能 / High - Really need this feature
-        - 中 - 有了更好 / Medium - Would be nice to have
-        - 低 - 可有可无 / Low - Optional
-    validations:
-      required: true
-
-  - type: textarea
-    id: problem
-    attributes:
-      label: 问题描述 / Problem Description
-      description: |
-        这个功能要解决什么问题？为什么需要这个功能？
-        What problem does this feature solve? Why is this feature needed?
-      placeholder: |
-        我遇到的问题是... / The problem I encountered is...
-
-        例如 / Example:
-        - 当前需要手动执行的操作太多，希望能自动化
-        - Currently too many manual operations are required, hoping to automate them
-    validations:
-      required: true
-
-  - type: textarea
-    id: solution
-    attributes:
-      label: 建议的解决方案 / Proposed Solution
-      description: |
-        您希望如何解决这个问题？详细描述您设想的功能。
-        How would you like to solve this problem? Describe the feature you envision in detail.
-      placeholder: |
-        我认为可以通过...来解决 / I think this can be solved by...
-
-        例如 / Example:
-        - 添加一个配置选项来控制自动化行为
-        - Add a configuration option to control automated behavior
-    validations:
-      required: true
-
-  - type: textarea
-    id: alternatives
-    attributes:
-      label: 替代方案 / Alternative Solutions
-      description: |
-        您考虑过其他解决方案吗？
-        Have you considered any alternative solutions?
-      placeholder: |
-        我也考虑过... / I also considered...
-
-        例如 / Example:
-        - 使用外部工具来实现类似功能
-        - Using external tools to achieve similar functionality
-
-  - type: checkboxes
-    id: confirmations
-    attributes:
-      label: 确认事项 / Confirmations
-      description: |
-        提交前请确认以下事项
-        Please confirm the following before submitting
-      options:
-        - label: |
-            我已经搜索了现有的 issues 和讨论，确认这不是重复建议
-            I have searched existing issues and discussions, confirming this is not a duplicate suggestion
-          required: true
-        - label: |
-            这个功能符合项目的目标和范围
-            This feature aligns with the project's goals and scope
-          required: true
-        - label: |
-            我理解这个功能可能需要时间来实现
-            I understand this feature may take time to implement
-          required: true
-        - label: |
-            我愿意协助实现这个功能 (可选)
-            I'm willing to help implement this feature (optional)
-          required: false

package/templates/.github/ISSUE_TEMPLATE/04_documentation.yml

@@ -1,165 +0,0 @@
-name: 📚 文档问题 / Documentation Issue
-description: 报告文档中的错误、缺失或改进建议 / Report documentation errors, missing content, or improvement suggestions
-labels:
-  - "type: documentation"
-  - "status: waiting-for-triage"
-type: Task
-body:
-  - type: markdown
-    attributes:
-      value: |
-        ## 感谢您帮助改进文档！/ Thank you for helping improve the documentation!
-
-        好的文档对项目至关重要。请详细描述文档问题，帮助我们提供更好的文档体验。
-        Good documentation is crucial for the project. Please describe the documentation issue in detail to help us provide a better documentation experience.
-
-  - type: input
-    id: summary
-    attributes:
-      label: 问题摘要 / Issue Summary
-      description: 用一句话简要描述文档问题 / Briefly describe the documentation issue in one sentence
-      placeholder: |
-        例如：API文档中缺少某个配置参数说明
-        Example: Missing configuration parameter description in API documentation
-    validations:
-      required: true
-
-  - type: dropdown
-    id: doc-type
-    attributes:
-      label: 文档类型 / Documentation Type
-      description: 这个问题涉及哪种类型的文档？/ Which type of documentation does this issue involve?
-      options:
-        - "README文件 / README file"
-        - "API文档 / API Documentation"
-        - "安装指南 / Installation Guide"
-        - "使用教程 / Usage Tutorial"
-        - "配置说明 / Configuration Guide"
-        - "故障排除 / Troubleshooting"
-        - "贡献指南 / Contributing Guide"
-        - "更新日志 / Changelog"
-        - "代码注释 / Code Comments"
-        - "其他 (请在下方说明) / Other (please specify below)"
-    validations:
-      required: true
-
-  - type: dropdown
-    id: issue-type
-    attributes:
-      label: 问题类型 / Issue Type
-      description: 这是什么类型的文档问题？/ What type of documentation issue is this?
-      options:
-        - "内容错误 / Content Error"
-        - "信息缺失 / Missing Information"
-        - "过时内容 / Outdated Content"
-        - "格式问题 / Formatting Issue"
-        - "链接失效 / Broken Link"
-        - "翻译问题 / Translation Issue"
-        - "结构改进 / Structure Improvement"
-        - "示例代码问题 / Example Code Issue"
-        - "其他 / Other"
-    validations:
-      required: true
-
-  - type: input
-    id: location
-    attributes:
-      label: 文档位置 / Document Location
-      description: |
-        请提供具体的文档位置信息
-        Please provide specific document location information
-      placeholder: |
-        例如：docs/api.md 第15行，或者 README.md 的"安装"部分
-        Example: Line 15 in docs/api.md, or "Installation" section in README.md
-    validations:
-      required: true
-
-  - type: textarea
-    id: current-content
-    attributes:
-      label: 当前内容 / Current Content
-      description: |
-        复制粘贴当前有问题的文档内容（如果适用）
-        Copy and paste the current problematic documentation content (if applicable)
-      placeholder: |
-        请粘贴当前的文档内容...
-        Please paste the current documentation content...
-      render: markdown
-
-  - type: textarea
-    id: issue-description
-    attributes:
-      label: 问题描述 / Issue Description
-      description: |
-        详细描述文档问题
-        Describe the documentation issue in detail
-      placeholder: |
-        详细说明问题所在... / Explain the issue in detail...
-
-        例如 / Example:
-        - 这段文档与实际功能不符
-        - This documentation doesn't match the actual functionality
-        - 缺少必要的参数说明
-        - Missing necessary parameter descriptions
-    validations:
-      required: true
-
-  - type: textarea
-    id: suggested-content
-    attributes:
-      label: 建议的内容 / Suggested Content
-      description: |
-        如果您有改进建议，请提供修正后的内容
-        If you have improvement suggestions, please provide the corrected content
-      placeholder: |
-        建议的文档内容... / Suggested documentation content...
-      render: markdown
-
-  - type: textarea
-    id: impact
-    attributes:
-      label: 影响范围 / Impact
-      description: |
-        这个文档问题对用户有什么影响？
-        What impact does this documentation issue have on users?
-      placeholder: |
-        这个问题可能导致... / This issue might cause...
-
-        例如 / Example:
-        - 用户无法正确配置项目
-        - Users cannot configure the project correctly
-        - 开发者集成时遇到困难
-        - Developers encounter difficulties during integration
-
-  - type: textarea
-    id: additional-context
-    attributes:
-      label: 额外信息 / Additional Context
-      description: |
-        添加任何其他有助于改进文档的信息，如截图、相关链接等
-        Add any other information that might help improve the documentation, such as screenshots, related links, etc.
-
-  - type: checkboxes
-    id: confirmations
-    attributes:
-      label: 确认事项 / Confirmations
-      description: |
-        提交前请确认以下事项
-        Please confirm the following before submitting
-      options:
-        - label: |
-            我已经搜索了现有的文档相关issues，确认这不是重复问题
-            I have searched existing documentation-related issues and confirmed this is not a duplicate
-          required: true
-        - label: |
-            我已经仔细阅读了相关的文档内容
-            I have carefully read the relevant documentation content
-          required: true
-        - label: |
-            我提供的信息准确完整
-            The information I provided is accurate and complete
-          required: true
-        - label: |
-            我愿意协助改进文档内容 (可选)
-            I'm willing to help improve the documentation content (optional)
-          required: false