这是AI时代催生的一种新型技术债，AI写代码太快了，文档永远跟不上，那么该如何解决，关于这个问题，发现其实可以通过制作相关的记录文档skill来使用AI Agent帮忙记录。
一、怎么用Skill解决AI开发如何记录文档的问题
一套叫 doc-first-dev 的东西：一组可以安装到 Claude Code 的 Agent Skills，把"文档先行"这套工作流强制固化下来。
核心是两个命令：
/spec-first：管理从需求到交付的完整开发周期。每次有新需求或变更，先写/更新文档，确认通过再开发，开发完再跑验收。/whylog-record：在任务结束后把这次的决策背景记录下来——考虑过哪些方案，为什么选现在这个，有什么取舍。
两个命令一起用，才能回答开发中最重要的两个问题：现在的代码是什么样的（spec）和为什么是这个样子（决策日志）。
二、记录文档SKill怎么安装
如果你想试试：
npx skills add zzusp/doc-first-dev
安装完之后，在你的项目里运行 /spec-first 加上一句需求描述，它会自动检测是否需要初始化，然后走流程。
项目地址：https://github.com/zzusp/doc-first-dev
三、适合场景
说实话，这套工具不是适合所有场景的。
适合：
- 你在维护一个要持续迭代的项目，而不是一次性脚本
- 你（或你的团队）用AI写了大量代码，但文档状态已经一团糟
- 你希望AI的每次修改都有迹可循，可以回溯
不太适合：
- 纯探索性的原型，你只是想快速验证一个想法
- 完全不在意文档的快速实验
- 项目生命周期很短，文档的投资回报不合算
以上就是怎么用Skill解决AI开发如何记录文档的问题的方法，使用它可以帮忙三个月后看不懂自己写的代码的问题，如果你有类似的困扰，可以试试。