对于项目 AI 规范最佳实践，大家有什么心得？

[sn0wdr1am]

现在的 AI 工具和规范是百家争鸣，百花齐放。 如果一个项目要尽可能去适配各种 AI IDE ，让他们都能够理解统一的规范，指导编程，应该怎么做？ 对于项目 AI 规范最佳实践，大家有什么心得？ 应该编写哪些规范文件，放在哪里？怎么组织起来？

AI IDE： vscode ，antigravity ，claude...

AI 扩展： continue cline...

AI 规范： GEMINI.md AGENTS.md CLAUDE.md ...

项目结构： .agent .aiconfig .antigravity .claude .cline .continue .copilot .roo .vscode ...

[577322753]

等等吧，感觉后面会统一的，比如 AGENT.md 、Skill 等，已经有了统一的趋势。
现有阶段的可以维护一份规范到远程仓库，再配套对应的脚本，支持多选 agent 后创建 agent 对应的文件结构，可以复制一份，也可以将公有文件夹的内容通过软连接的形式关联起来

[gaogao321]

我是创建一个 AGENT.md ，然后其他的.claude .cline .continue .copilot 等，都创建个软连接指向 AGENT.md ，这样只需要改一个文件就好了

[wombat]

团队 spec coding 半年多，项目基本都是 ai 编写。当前的方案是，所有的工具创建的配置文件一律加入.gitignore ，不提交到仓库。 全局定义了项目级别共用提示词，包含设计规范、代码规范以及特定的规范，不管个人喜欢什么工具或者模型，在文档以及代码生成时必须读取相同的规范，减少差异性。 不然有人喜欢 codex ，有人喜欢 opencode+glm ，有人喜欢 claude code ，代码风格和质量千差万别，完全是灾难。

[DosLee]

@wombat 佬。这些提示词有推荐仓库吗，我去学习一下。以前都是在输入框跟 ai 说的，上下文一多“规范”就被稀释了

[cleveryun]

1 、主入口就是通用的 AGENTS.md 。
2 、其他编辑器特有.md 文件里直接写一句类型请参考 项目根目录下的 @AGENTS.md ，不加任何其他内容。
3 、内容较多放到一个 AGENTS.md 里不合适，就建一个文档目录，把内容拆出去，然后再 AGENTS.md 里引用。

[riceball]

不可能有所谓统一的项目规范最佳实践，每个公司，乃至架构师、资深开发者都有自己的一套"最佳“实践！

[livib]

还在摸索阶段，但是有一些规范可能稍微好点

[connectsixboy]

有了解 spec kit 和 openspec 么，看到有人提到，但不知道配合 Claude code 的最佳实践怎么搞？

[wombat]

@DosLee 没有仓库，这个提示词就是不断优化的过程。
根据你们不同的场景使用不同的 markdown 约束。 哪些是人参与的、哪些是 ai 参与的。然后用 markdown 约定不同步骤的输入、输出。 比如需求-> 产品设计、产品设计->功能设计、功能设计->代码设计、代码设计->具体的开发任务、外加单独的代码规范。
因为模型上文本长度限制，最好是每次让他在一个窗口内完成尽量小的任务，下一次换个窗口，然后需要连续任务使用的，就让 ai 写 markdown ，或者提示词里让他先读一个先前的代码，了解规则。
不要迷信 ai ，特别是大项目，用的话一定要规划好，人一定要 review 。