agentic coding 本质上是文档管理的艺术
- -今天回东京后继续研究 agentic coding，由于本地项目是从 0 搭建的，需求和文档随着和 codex 和 cc 的沟通越来越明确，文档的复杂程度也逐渐加深. 这让我越来越觉得 agentic coding 本质上是文档管理的艺术，从 vibe coding 发展了一年后，自然语言编程似乎慢慢将软件工程转换为了文档工程.
agentic coding 本质上是文档管理的艺术
标签：
| 发表时间：2025-12-23 09:59 | 作者：
出处：https://x.com
今天回东京后继续研究 agentic coding，由于本地项目是从 0 搭建的，需求和文档随着和 codex 和 cc 的沟通越来越明确，文档的复杂程度也逐渐加深。
这让我越来越觉得 agentic coding 本质上是文档管理的艺术，从 vibe coding 发展了一年后，自然语言编程似乎慢慢将软件工程转换为了文档工程。
最初，需求极其模糊。llm 会按照自己的想法为我们想做的事情设定一个 roadmap 和 mvp 版本，这是从零开始的第一步，它决定了迭代的大版本号。我一般会让 llm 在本地生成两个文件，第一个毫无疑问是 agent constitution，第二个是 http://roadmap.md 这是非常重要的文件，所有的需求，都会从这个文件的迭代 session 中派生出来，顺序是 roadmap:v0.1 -> stories/xxx.md 这里的 story 其实就是需求白板中的任务，它可能涉及到 API 或者 UI，包含几个甚至十几个复杂的任务，每一个 story 文件，都会是一个单独的文件，涵盖着某个可被测试的需求完整的结构，任务完成情况和相关联的文件路径。
stories 文件夹中每完成一个需求，我会要求 codex / cc 在 docs 对应的路径创建一系列 md 文档，以标记一个功能所涉及到的状态，如果这个功能产生了 bug，就在修复 bug 的过程中继续在这个文档中记录 bug 修复进度，于此同时，也要求它按照文档结构来组织 lib 或 api router 文件。以此类推，文档系统会形成一个巨大的网状结构，最终，它会成为整个产品的故事和描述文件。
传统的软件工程里，这个是产品经理干的活儿。但对于自然语言编程来说，这个任务变成了工程师的责任。一开始，我还设计了一个 architecture 文档，以要求 cc 用对应的技术栈来完成功能，后来，我发现随着软件的生长，强行要求一个万能的程序员按照人类的技术栈来实现功能并没有什么意义（维护已存在的项目除外）所以我废弃了这个文件，只维护产品故事和需求描述。
在整个 agentic coding 的过程中，我基本上只和文档打交道，在另外一个浏览器界面等待完成的需求被刷新，没关心过代码重构和其他技术问题，这让编程（如果还能这样定义它的话）成为了一种极其容易进入心流的对话情境，以我个人的体验来说，这是一件非常好的事儿。如果你没体验过 agentic coding，我推荐大家尝试一下！
这让我越来越觉得 agentic coding 本质上是文档管理的艺术，从 vibe coding 发展了一年后，自然语言编程似乎慢慢将软件工程转换为了文档工程。
最初，需求极其模糊。llm 会按照自己的想法为我们想做的事情设定一个 roadmap 和 mvp 版本，这是从零开始的第一步，它决定了迭代的大版本号。我一般会让 llm 在本地生成两个文件，第一个毫无疑问是 agent constitution，第二个是 http://roadmap.md 这是非常重要的文件，所有的需求，都会从这个文件的迭代 session 中派生出来，顺序是 roadmap:v0.1 -> stories/xxx.md 这里的 story 其实就是需求白板中的任务，它可能涉及到 API 或者 UI，包含几个甚至十几个复杂的任务，每一个 story 文件，都会是一个单独的文件，涵盖着某个可被测试的需求完整的结构，任务完成情况和相关联的文件路径。
stories 文件夹中每完成一个需求，我会要求 codex / cc 在 docs 对应的路径创建一系列 md 文档，以标记一个功能所涉及到的状态，如果这个功能产生了 bug，就在修复 bug 的过程中继续在这个文档中记录 bug 修复进度，于此同时，也要求它按照文档结构来组织 lib 或 api router 文件。以此类推，文档系统会形成一个巨大的网状结构，最终，它会成为整个产品的故事和描述文件。
传统的软件工程里，这个是产品经理干的活儿。但对于自然语言编程来说，这个任务变成了工程师的责任。一开始，我还设计了一个 architecture 文档，以要求 cc 用对应的技术栈来完成功能，后来，我发现随着软件的生长，强行要求一个万能的程序员按照人类的技术栈来实现功能并没有什么意义（维护已存在的项目除外）所以我废弃了这个文件，只维护产品故事和需求描述。
在整个 agentic coding 的过程中，我基本上只和文档打交道，在另外一个浏览器界面等待完成的需求被刷新，没关心过代码重构和其他技术问题，这让编程（如果还能这样定义它的话）成为了一种极其容易进入心流的对话情境，以我个人的体验来说，这是一件非常好的事儿。如果你没体验过 agentic coding，我推荐大家尝试一下！
相关 [agentic coding 本质] 推荐：
zen coding 0.7发布
- adow - islightingzen coding 更新到0.7版本，这次更新还是很有亮点的. 最令人欣喜的恐怕是群组展开功能，这在以前需要分段来完成，而现在，只要你愿意，可以用一句表达式从头写到尾，一个module几乎可以一气呵成. 另外一个重要的更新是可以编写节点的属性和文本，要编写小段的html也方便许多，如. 更多的更新内容请看0.7 release notes，这里还有一个web版，可以体验下zen coding的强大功能.
coding-interview-university/README-cn.md at master · jwasham/coding-interview-university · GitHub
- -[译] Coding Interview University 一套完整的学习手册帮助自己准备 Google 的面试. 这是我为了从 web 开发者（自学、非计算机科学学位）蜕变至 Google 软件工程师所制定的计划，其内容历时数月. Google 的指导笔记中萃取出来并进行扩展. 因此，有些事情你必须去了解一下.
Zen Coding – 超快地写网页代码
- - haohtml's blog上次在北京看到善用佳软的 xBeta 演示 VIM 的时候，@ sfufoet 我就被强烈震撼到了. VIM 的确是个强大的编辑器，它可以折腾出很多种强大的功能. 今天看到这个叫 Zen Coding 的东西，我强烈推荐给经常和 HTML CSS 打交道的朋友. 下面的动态演示图，只是它强大功能的一部分而已.
ABC: Always Be Coding——程序员面试必读
- - 36氪 | 关注互联网创业@guitardave24">David Byttow是一名程序员，曾在Google和Square等公司工作过. 在正文之前，先让我们回答几个简单的问题：第一，你面试过多少家公司；第二，这些公司中，录取你的有多少. 记下这两个数字，然后代入下面这个算式中（为我自己发明，仅供参考，不具有其他意义）：.
Beyond Vibe Coding - AI 辅助开发指南
- -Beyond Vibe Coding - AI 辅助开发指南. 的新书，目的是纠正当前流行的 “Vibe Coding” 误区，为构建生产级软件提供一套严谨的 AI 辅助工程学框架. 这本书我是在 Oreilly 在线阅读的，应该也能找到 PDF 版本. 核心论点：从“氛围编码”到“AI 辅助工程”
1.
一些PHP Coding Tips[2011/04/02最后更新]
- 硬盘被格 - 风雪之隅作者: Laruence(. 本文地址: http://www.laruence.com/2011/03/24/858.html. 以下是一些PHP Coding Tips. 当然, 这些Tips并不一定仅仅局限于PHP. 大家有什么好的心得, 欢迎直接回复本文与更多的人分享. 本文长期更新, 请关注PHP Coding Tips.
评判云服务靠谱程度 -- Coding 安全那些事 - Coding.net
- - 博客园_首页本文依据孙宇聪在 SegmentFault D-Day 北京场的演讲内容整理，并授权首发于“高效运维”公众号. 10月11日，SegmentFault 将在上海举办D-Day，围绕 Docker 主题. Coding.net WebIDE 项目负责杜万将受邀参与分享《Docker Container 磁盘容量限制》.
Agent 讓 RAG 過時了嗎? 談 AI Coding 的檢索策略
- - ihower { blogging }看了一場 Augment Code (也是一家做 AI IDE 的廠商) 來講 “Agentic 檢索” 對比 “傳統 RAG 檢索” 的演講，蠻有啟發的. 在 AI Coding 領域，簡單的工具正在擊敗複雜的 RAG 系統. AI Coding 的演進歷程. AI Coding 的演進是這樣:.
目前前端 Vibe Coding两种主流方案
- -目前前端 Vibe Coding有两种主流方案：. 一种是通过专注于前端编写的AI来编写，此类选择有v0、same、bolt、21st等在线网站Agent. 一种是通过 Claude、Codex、Gemini 等 CLI 终端来编写. 第三种方案是通过 AIStuidio build 编写前端，完全免费.