-
Notifications
You must be signed in to change notification settings - Fork 3
在 CONTRIBUTING.md 中补充 AI 协作约定 #31
Copy link
Copy link
Open
Labels
area:docsDocumentation, guides, and contributor docsDocumentation, guides, and contributor docsstatus:readyTriaged and ready to pick upTriaged and ready to pick uptype:maintenanceRefactor, tooling, chores, or non-user-facing upkeepRefactor, tooling, chores, or non-user-facing upkeep
Metadata
Metadata
Assignees
Labels
area:docsDocumentation, guides, and contributor docsDocumentation, guides, and contributor docsstatus:readyTriaged and ready to pick upTriaged and ready to pick uptype:maintenanceRefactor, tooling, chores, or non-user-facing upkeepRefactor, tooling, chores, or non-user-facing upkeep
Problem
CONTRIBUTING.md当前没有针对"使用 AI 工具协作"的明确约定。HALF 的主题就是 agent 协作平台,外部贡献者越来越可能用 Claude Code、Copilot、Cursor 等工具辅助开发,缺少约定容易出现"AI 直接提交未经人工 review 的 PR"等问题。Proposed Change
在
CONTRIBUTING.md新增一节,标题中性(如## Using AI Assistants),覆盖:本质上是 contributor policy(贡献流程规范),不是普通文档补充。
Why It Matters
明确约定能预防外部 PR 出现常见的 AI 协作陷阱(粗放修改、未人工把关、改动越界),同时对熟悉 agent 协作的贡献者展示 HALF 项目本身在这方面的成熟度。
Additional Context
CLAUDE.md/AGENTS.md(绑定特定 AI 工具生态,且与项目已有的中性立场冲突)docs/contributing-with-ai.md,CONTRIBUTING.md 保留链接