Agent Skills
返回列表
AI 编程规范初始化

AI 编程规范初始化

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md 的指引，将 @user_a6457d4e/ai-coding-proj-init 安装到你的 AI 助手中。

技能介绍

问题

同一个项目经常被多个 AI 编程代理同时修改：有的按 Markdown 风格写注释，有的把 console.log 留在提交里，有的绕过 CONTRIBUTING.md 直接改源码。根因不是模型能力，而是缺少一份可被机器读取的协作约定。团队的规范散落在文档站、wiki 和聊天记录里，代理启动时根本看不到。

工作方式

这个技能采用零逻辑设计：启动时不注入脚本，而是通过引用 @AGENTS.md 文件把项目约定喂给代理上下文。代理会将其中的目录约定、命名规则、提交信息格式与禁用项自然应用到后续的代码生成、审查、重构、测试与文档任务中。

边界与注意

  • 只初始化规范，不自动改写代码或添加工具配置。
  • @AGENTS.md 中的条目必须在仓库内可被所有成员审查，避免一次性塞入长规则。
  • 不同代理对长上下文的遵循能力不同，规则过密时建议合并同类项。
  • 不涉及 CI、权限或部署流程，仅覆盖仓库协作约定。

使用场景

  • 代码生成时遵循目录约定，适用于代理需要把新模块放入指定目录结构。
  • 审查代码时按命名与注释规则，适用于代理需要检查命名和注释一致性。
  • 提交信息生成时按格式规范，适用于代理需要按团队规范撰写提交信息。
  • 重构代码时按禁用项约束，适用于代理需要避免引入被禁止的调试代码或依赖。

适合人员

  • 工程师，需要让多个 AI 代理在同一仓库里产出统一格式的代码与提交信息。
  • 开源维护者，需要让贡献者和代理都遵守同一份项目约定，减少反复修改。
  • 技术负责人，需要让 AI 代理遵循目录与命名规范，避免混放文件或破坏结构。