SuperAPI AI 工具集

contribute

编程与开发

查看项目

更新于 10-27 00:36

技能介绍

该技能面向 gcx 代码库的贡献工作,帮助贡献者在检出目录内完成缺陷报告或修复、文档更新,以及功能提案与代码实现。其核心是遵循 AGENTS.md 和权威贡献流程中的路由与所有权指引,贡献者不需要在开始前选择提供商、数据源或 RFC 工作流。

使用方式按步骤展开:首先确定当前步骤,识别请求结果以及已有的 issue、已接受决策、RFC 或实现分支,检查记录与相关代码后再提问,说明适用路由、当前步骤和缺失的维护者决策。其次,在路由需要时准备 issue:文档变更和缺陷修复可直接提交 PR;其他代码贡献需要已接受的 issue,并在其中协调工作;产品团队在既有负责区域内可适用例外。创建 issue 或开始实现前,应搜索仓库中开放和已关闭的 issue,复用相关 issue 并检查其结果与维护者决策。缺陷修复可直接进入 PR,无需单独 issue 或事先维护者确认;报告缺陷时先搜索已有报告,若无匹配则使用 Bug report 表单,明确实际与预期行为、复现或证据以及版本环境。功能提案使用 propose-feature 研究并起草通用提案,展示具体问题、提议的 UX 和可检查的验收标准。

然后按需加载计划:遵循 CONTRIBUTING 中关于新功能 RFC 要求和产品团队例外的规定,使用 create-rfc 进行所需设计,使用 review-rfc 进行设计评审,使用 update-rfc 在明确要求时协调现有实现证据。开发者可自行选择实现和计划方式,复用已接受 issue 和 RFC 的范围与验收标准。

实现阶段,缺陷需检查相关子系统并添加适当的回归覆盖;文档或仅测试工作检查受影响材料;能力或命令变更需阅读能力实现以了解放置位置、后端就绪和命令契约,然后按需加载提供商实现、数据源实现或分发与门禁相关内容。常规选择从仓库证据中解决,未解决且实质性改变范围或行为的选项需询问,并保留 CONSTITUTION、DESIGN 和架构规则。

最后验证并准备评审:阅读 self-review 并应用由实际 diff 触发的检查,运行 AGENTS.md 质量检查和相关领域验证,报告失败或不可用检查及原因;未运行的测试或探测不能视为通过。存在 issue 时,实现 PR 引用它,最终完成 PR 关闭它;总结变更、检查、未解决假设和记录偏差供评审。