@fitlab-ai/agent-infra 0.3.0

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

@@ -0,0 +1,131 @@
+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

@@ -0,0 +1,165 @@
+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

package/templates/.github/ISSUE_TEMPLATE/05_other.yml

@@ -0,0 +1,147 @@
+name: 🔧 其他问题 / Other Issues
+description: 报告不属于上述分类的其他问题或建议 / Report other issues or suggestions that don't fit the above categories
+labels:
+  - "status: waiting-for-triage"
+type: Task
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## 提交其他类型的问题 / Submit Other Types of Issues
+
+        如果您的问题不属于问题报告、问题咨询、功能请求或文档问题，请使用此模板。
+        If your issue doesn't belong to bug reports, questions, feature requests or documentation issues, please use this template.
+
+        **在提交前，请确认您的问题确实不属于以下类别：**
+        **Before submitting, please confirm your issue doesn't belong to the following categories:**
+        - 🐛 [问题报告 / Bug Report](./issues/new?template=01_bug_report.yml) - 项目功能错误
+        - ❓ [问题咨询 / Question](./issues/new?template=02_question.yml) - 使用相关问题
+        - ✨ [功能请求 / Feature Request](./issues/new?template=03_feature_request.yml) - 新功能建议
+        - 📚 [文档问题 / Documentation](./issues/new?template=04_documentation.yml) - 文档相关问题
+
+  - type: input
+    id: summary
+    attributes:
+      label: 问题摘要 / Issue Summary
+      description: 用一句话简要描述您的问题或建议 / Briefly describe your issue or suggestion in one sentence
+      placeholder: |
+        例如：建议添加 GitHub Actions CI/CD 工作流
+        Example: Suggest adding GitHub Actions CI/CD workflow
+    validations:
+      required: true
+
+  - type: dropdown
+    id: category
+    attributes:
+      label: 问题类别 / Issue Category
+      description: 请选择最接近的问题类别 / Please select the closest issue category
+      options:
+        - "项目管理 / Project Management"
+        - "开发工具 / Development Tools"
+        - "CI/CD相关 / CI/CD Related"
+        - "安全相关 / Security Related"
+        - "许可证问题 / License Issues"
+        - "社区建议 / Community Suggestions"
+        - "第三方集成 / Third-party Integration"
+        - "环境配置 / Environment Setup"
+        - "版本发布 / Release Management"
+        - "其他 (请在描述中说明) / Other (please specify in description)"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: 优先级 / Priority
+      description: 您认为这个问题的重要程度如何？/ How important do you think this issue is?
+      options:
+        - "高 - 影响项目正常运行 / High - Affects normal project operation"
+        - "中 - 有一定影响 / Medium - Has some impact"
+        - "低 - 优化改进建议 / Low - Optimization/improvement suggestion"
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: 详细描述 / Detailed Description
+      description: |
+        详细描述您的问题、建议或需求
+        Describe your issue, suggestion, or requirement in detail
+      placeholder: |
+        请详细说明... / Please explain in detail...
+
+        包括但不限于 / Including but not limited to:
+        - 问题的背景和原因 / Background and reasons for the issue
+        - 具体的需求或建议 / Specific requirements or suggestions
+        - 对项目的影响 / Impact on the project
+        - 您认为的解决方案 / Your proposed solution
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: 相关背景 / Related Context
+      description: |
+        提供任何相关的背景信息
+        Provide any relevant background information
+      placeholder: |
+        相关信息... / Related information...
+
+        例如 / Example:
+        - 相关的外部工具或服务 / Related external tools or services
+        - 类似项目的实现方式 / Implementation approaches in similar projects
+        - 相关的讨论或文章链接 / Links to relevant discussions or articles
+
+  - type: textarea
+    id: impact
+    attributes:
+      label: 影响评估 / Impact Assessment
+      description: |
+        这个问题或建议会对项目产生什么影响？
+        What impact would this issue or suggestion have on the project?
+      placeholder: |
+        可能的影响... / Potential impacts...
+
+        例如 / Example:
+        - 对开发流程的影响 / Impact on development workflow
+        - 对用户体验的影响 / Impact on user experience
+        - 对项目维护的影响 / Impact on project maintenance
+
+  - type: textarea
+    id: additional-info
+    attributes:
+      label: 补充信息 / Additional Information
+      description: |
+        添加任何其他有用的信息，如截图、链接、参考资料等
+        Add any other useful information such as screenshots, links, references, etc.
+
+  - type: checkboxes
+    id: confirmations
+    attributes:
+      label: 确认事项 / Confirmations
+      description: |
+        提交前请确认以下事项
+        Please confirm the following before submitting
+      options:
+        - label: |
+            我已经确认这个问题不属于Bug报告、功能请求、问题咨询或文档问题
+            I have confirmed this issue doesn't belong to bug reports, feature requests, questions, or documentation issues
+          required: true
+        - label: |
+            我已经搜索了现有的issues，确认这不是重复问题
+            I have searched existing issues and confirmed this is not a duplicate
+          required: true
+        - label: |
+            我提供的信息清晰准确
+            The information I provided is clear and accurate
+          required: true
+        - label: |
+            我理解这类问题可能需要更多时间来评估和处理
+            I understand this type of issue may require more time to evaluate and process
+          required: true
+        - label: |
+            我愿意提供更多信息或协助解决 (可选)
+            I'm willing to provide more information or help resolve the issue (optional)
+          required: false

package/templates/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 📖 项目文档 / Project Documentation
+    url: https://github.com/{{org}}/{{project}}/wiki
+    about: 查看项目文档和使用指南 / View project documentation and usage guides
+  - name: 💬 讨论区 / Discussions
+    url: https://github.com/{{org}}/{{project}}/discussions
+    about: 加入社区讨论，分享想法和经验 / Join community discussions, share ideas and experiences
+  - name: 🆘 获取帮助 / Get Help
+    url: https://github.com/{{org}}/{{project}}/discussions/categories/q-a
+    about: 在Q&A区域获取使用帮助 / Get usage help in the Q&A section

package/templates/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,123 @@
+<!--
+如果您正在寻求帮助，请先在我们的讨论区中进行交流。
+If you're looking for help, please check our Discussions section first.
+
+我们鼓励使用英文，如果不能直接使用，可以使用翻译软件，您仍旧可以保留中文原文。
+Please try to use English to describe your issue, or at least provide a snippet of English translation.
+
+请不要在没有创建 Issue 的情况下创建 Pull Request。
+Please do not create a Pull Request without creating an issue first.
+
+微小的变更（如错别字修复）不需要创建 Issue。
+Trivial changes like typos do not require a Github issue.
+
+提交 PR 之前请务必先阅读我们的贡献指南。
+Please read our Contributing Guide(CONTRIBUTING.md) before submitting your Pull Request.
+
+⚠️ 注意 / Note：
+
+不要重复创建类似的 PR，当你发现需要调整一个 PR 的时候，优先选择编辑修改它，而不是关闭之后再创建一个。
+Do not create a Pull Request without creating an issue first.
+-->
+
+## 🔗 相关问题 / Related Issue
+
+<!-- 请先创建 Issue 讨论，然后在这里链接 -->
+<!-- Please create an issue for discussion first, then link it here -->
+
+**Issue 链接 / Issue Link:** <mark>#{$IssueNumber}</mark> 👈👈
+
+<!-- 请修改 {$IssueNumber} 为真实的编号。 -->
+<!-- Please update {$IssueNumber} to an actual number. -->
+
+- [ ] 我已经创建了相关 Issue 并进行了讨论 / I have created and discussed the related issue
+- [ ] 这是一个微小的修改（如错别字），不需要 Issue / This is a trivial change (like typo fix) that doesn't need an issue
+
+## 📋 变更类型 / Type of Change
+
+- [ ] 🐛 Bug 修复 / Bug fix (non-breaking change which fixes an issue)
+- [ ] ✨ 新功能 / New feature (non-breaking change which adds functionality)
+- [ ] 💥 破坏性变更 / Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] 📚 文档更新 / Documentation update
+- [ ] 🔧 重构 / Refactoring (no functional changes)
+- [ ] ⚡ 性能优化 / Performance improvement
+- [ ] 📦 依赖升级 / Dependency upgrade (update dependencies to newer versions)
+- [ ] 🚀 功能增强 / Feature enhancement (improve existing functionality without breaking changes)
+- [ ] 🧹 代码清理 / Code cleanup
+
+## 📝 变更目的 / Purpose of the Change
+
+<!-- 详细描述这个变更的目的和必要性 -->
+<!-- Detailed description of the purpose and necessity of this change -->
+
+## 📋 主要变更 / Brief Changelog
+
+<!-- 列出主要的变更内容 -->
+<!-- List the main changes -->
+
+-
+-
+-
+
+## 🧪 验证变更 / Verifying this Change
+
+<!-- 描述如何验证这个变更是正确的 -->
+<!-- Describe how to verify that this change is correct -->
+
+### 测试步骤 / Test Steps
+
+1.
+2.
+3.
+
+### 测试覆盖 / Test Coverage
+
+- [ ] 我已经添加了单元测试 / I have added unit tests
+- [ ] 所有现有测试都通过 / All existing tests pass
+- [ ] 我已经进行了手动测试 / I have performed manual testing
+
+## 📸 截图 / Screenshots
+
+<!-- 如果适用，请添加截图来展示变更效果 -->
+<!-- If applicable, add screenshots to demonstrate the changes -->
+
+## ✅ 贡献者检查清单 / Contributor Checklist
+
+请确保你的 Pull Request 符合以下要求 / Please ensure your Pull Request meets the following requirements:
+
+**基本要求 / Basic Requirements:**
+
+- [ ] 确保有 GitHub Issue 对应这个变更（微小变更如错别字除外）/ Make sure there is a Github issue filed for the change (trivial changes like typos excluded)
+- [ ] 你的 Pull Request 只解决一个 Issue，没有包含其他不相关的变更 / Your PR addresses just this issue, without pulling in other changes - one PR resolves one issue
+- [ ] PR 中的每个 commit 都有有意义的主题行和描述 / Each commit in the PR has a meaningful subject line and body
+
+**代码质量 / Code Quality:**
+
+- [ ] 我的代码遵循项目的代码规范 / My code follows the project's coding standards
+- [ ] 我已经进行了自我代码审查 / I have performed a self-review of my code
+- [ ] 我已经为复杂的代码添加了必要的注释 / I have commented my code, particularly in hard-to-understand areas
+
+**测试要求 / Testing Requirements:**
+
+- [ ] 我已经编写了必要的单元测试来验证逻辑正确性 / I have written necessary unit-tests to verify the logic correction
+- [ ] 当存在跨模块依赖时，我尽量使用了 mock / I have used mocks when cross-module dependencies exist
+- [ ] 代码检查通过 / Lint checks pass
+- [ ] 单元测试通过 / Unit tests pass
+
+**文档和兼容性 / Documentation and Compatibility:**
+
+- [ ] 我已经更新了相应的文档 / I have made corresponding changes to the documentation
+- [ ] 如果有破坏性变更，我已经在 PR 描述中详细说明 / If there are breaking changes, I have documented them in detail
+- [ ] 我已经考虑了向后兼容性 / I have considered backward compatibility
+
+## 📋 附加信息 / Additional Notes
+
+<!-- 任何其他相关信息，如已知问题、后续计划等 -->
+<!-- Any other relevant information, such as known issues, future plans, etc. -->
+
+---
+
+**审查者注意事项 / Reviewer Notes:**
+
+<!-- 为审查者提供的特殊说明或需要重点关注的地方 -->
+<!-- Special instructions for reviewers or areas that need special attention -->

package/templates/.github/dependabot.yml

@@ -0,0 +1,17 @@
+version: 2
+updates:
+  # TODO: add your project's package ecosystem (npm, pip, maven, gradle, etc.)
+  # - package-ecosystem: "npm"
+  #   directory: "/"
+  #   schedule:
+  #     interval: "weekly"
+  #   labels:
+  #     - "dependencies"
+  #   open-pull-requests-limit: 10
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "dependencies"

package/templates/.github/hooks/check-utf8-encoding.sh

@@ -0,0 +1,25 @@
+#!/bin/sh
+set -e
+
+echo "UTF-8 check script is running..."
+
+# Iterate over every file that is in the staging area
+for FILE in $(git diff --cached --name-only); do
+    # If file exists
+    # shellcheck disable=SC2039
+    if [[ -e "$FILE" ]]; then
+        if [[ $(file -bi "$FILE") != *"charset=binary"* ]]; then
+            # Get file encoding
+            encoding=$(file -bi "$FILE" | sed -e 's/.*[ ]charset=//')
+            echo "Checking file $FILE (encoding: $encoding)"
+
+            # If encoding is not utf-8 or us-ascii, exit with failure status
+            if ! echo "$encoding" | grep -q -e 'utf-8' -e 'us-ascii'; then
+                echo "Error: File $FILE is not UTF-8 encoded or US-ASCII, it is $encoding. Please convert it to UTF-8."
+                exit 1
+            fi
+        fi
+    fi
+done
+
+echo "UTF-8 check completed successfully."

package/templates/.github/release.yml

@@ -0,0 +1,27 @@
+changelog:
+  exclude:
+    labels:
+      - skip-changelog
+    authors:
+      - dependabot
+  categories:
+    - title: "⚠️ Breaking Changes"
+      labels:
+        - breaking
+    - title: "✨ Enhancement"
+      labels:
+        - enhancement
+        - feature
+    - title: "🐛 Bug Fixes"
+      labels:
+        - bug
+        - fix
+    - title: "📚 Documentation"
+      labels:
+        - documentation
+    - title: "📦 Dependencies"
+      labels:
+        - dependencies
+    - title: "Other Changes"
+      labels:
+        - "*"