• 请不要在回答技术问题时复制粘贴 AI 生成的内容
bwnjnOEI
V2EX  ›  程序员

你们是怎么将文档和代码对齐的?

  •  
  •   bwnjnOEI · 19h 13m ago · 1580 views

    以及修改代码后如何保证文档不被改烂,还有就现在 agent 的输出都能读下去吗?如何应对高信息密度的输出和那些令人抓狂的内容。

    11 replies    2026-08-01 16:32:31 +08:00
    gausszhou
        1
    gausszhou  
       16h 50m ago
    只看结论
    Anarchy
        2
    Anarchy  
       14h 29m ago
    Agent 最后会有一个结论报告,看那个就可以。文档和代码做好分层,思想和 skill 的概念是差不多的,另外文档属于 AI 写的 AI 看,你不用太介意文档本身质量,只关心 AI 工作的结果就可以了。
    avenger
        3
    avenger  
       12h 59m ago   ❤️ 1
    好的代码
    就是最好的文档
    Godblessu
        4
    Godblessu  
       12h 27m ago
    @avenger 好的文档亦是最好的代码,有好的文档可以写无数种可能
    ericguo
        5
    ericguo  
       11h 37m ago   ❤️ 1
    文档少写就对齐了,文档是宪法,代码是条例
    redbule
        6
    redbule  
       10h 41m ago via Android
    有 ai 了,不需要文档。代码在不断变化,需要的时候就靠 ai 输出一次文档,每次都要最新的输出
    wetalk
        7
    wetalk  
       10h 40m ago
    @Godblessu #4 好文档你也不可能逐字逐句看,信息过载时代,文档最大的价值就是对 ai 有用
    crocoBaby
        8
    crocoBaby  
       10h 40m ago
    创建一个 md,设置 agent 每次修改完成之后都同步更新 md
    Godblessu
        9
    Godblessu  
       9h 34m ago
    @wetalk 日企都是面向文档开发
    SenseHu
        10
    SenseHu  
       3h 31m ago
    每次改完代码 让他自己更新文档咯, 推荐个框架 trellis, 好用的很
    THESDZ
        11
    THESDZ  
       3h 26m ago
    看你是文档导向还是代码导向,有完整的开发流程,就文档先行,然后测试用例+自动化测试+变更日志兜底,不关心代码本身。
    假如你的文档也就那样,那就代码即文档,用规范的设计(如接口代替细节,规范命名等),让代码自解释(即:开发人员或者 AI 不需要关注实现细节,只关注接口命名等),当然还是要配合测试用例和自动化测试兜底。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   2656 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 40ms · UTC 11:58 · PVG 19:58 · LAX 04:58 · JFK 07:58
    ♥ Do have faith in what you're doing.