对于项目 AI 规范最佳实践,大家有什么心得? - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术问题时复制粘贴 AI 生成的内容
sn0wdr1am
V2EX    程序员

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

 
  •   sn0wdr1am 1 月 29 日 2379 次点击

    现在的 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 ...

    9 条回复    2026-02-01 11:57:28 +08:00
    577322753
        1
    577322753  
       1 月 29 日
    等等吧,感觉后面会统一的,比如 AGENT.md 、Skill 等,已经有了统一的趋势。
    现有阶段的可以维护一份规范到远程仓库,再配套对应的脚本,支持多选 agent 后创建 agent 对应的文件结构,可以复制一份,也可以将公有文件夹的内容通过软连接的形式关联起来
    gaogao321
        2
    gaogao321  
       1 月 29 日
    我是创建一个 AGENT.md ,然后其他的.claude .cline .continue .copilot 等,都创建个软连接指向 AGENT.md ,这样只需要改一个文件就好了
    wombat
        3
    wombat  
       1 月 29 日
    团队 spec coding 半年多,项目基本都是 ai 编写。当前的方案是,所有的工具创建的配置文件一律加入.gitignore ,不提交到仓库。 全局定义了项目级别共用提示词,包含设计规范、代码规范以及特定的规范,不管个人喜欢什么工具或者模型,在文档以及代码生成时必须读取相同的规范,减少差异性。 不然有人喜欢 codex ,有人喜欢 opencode+glm ,有人喜欢 claude code ,代码风格和质量千差万别,完全是灾难。
    DosLee
        4
    DosLee  
       1 月 29 日
    @wombat 佬。这些提示词有推荐仓库吗,我去学习一下。以前都是在输入框跟 ai 说的,上下文一多“规范”就被稀释了
    cleveryun
        5
    cleveryun  
       1 月 29 日
    1 、主入口就是通用的 AGENTS.md
    2 、其他编辑器特有.md 文件里直接写一句类型请参考 项目根目录下的 @AGENTS.md ,不加任何其他内容。
    3 、内容较多放到一个 AGENTS.md 里不合适,就建一个文档目录,把内容拆出去,然后再 AGENTS.md 里引用。
    riceball
        6
    riceball  
       1 月 29 日
    不可能有所谓统一的项目规范最佳实践,每个公司,乃至架构师、资深开发者都有自己的一套"最佳“实践!
    livib
        7
    livib  
       1 月 29 日
    还在摸索阶段,但是有一些规范可能稍微好点
    connectsixboy
        8
    connectsixboy  
       1 月 30 日
    有了解 spec kit 和 openspec 么,看到有人提到,但不知道配合 Claude code 的最佳实践怎么搞?
    wombat
        9
    wombat  
       10 天前
    @DosLee 没有仓库,这个提示词就是不断优化的过程。
    根据你们不同的场景使用不同的 markdown 约束。 哪些是人参与的、哪些是 ai 参与的。然后用 markdown 约定不同步骤的输入、输出。 比如需求-> 产品设计、产品设计->功能设计、功能设计->代码设计、代码设计->具体的开发任务、外加单独的代码规范。
    因为模型上文本长度限制,最好是每次让他在一个窗口内完成尽量小的任务,下一次换个窗口,然后需要连续任务使用的,就让 ai 写 markdown ,或者提示词里让他先读一个先前的代码,了解规则。
    不要迷信 ai ,特别是大项目,用的话一定要规划好,人一定要 review 。
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     2078 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 24ms UTC 13:48 PVG 21:48 LAX 05:48 JFK 08:48
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86