Agent 时代,需要自己看官方文档学习吗?

10 阅读2分钟

在前面几年,学习一个东西,最好的思路,是去看官方文档,里面的东西最全也最准确,AI 也开始能够辅助人做一些文章类的编写。

现在 Agent 时代,AI 有了自己的“思维模式”,加上 skill 的加持,更能把文档写的很好了,他知道你想要什么。

那,我能否,通过他来帮我看文档,帮我总结精华呢?最近在把 SDD 模式接入开发,选了一个使用 node 的 OpenSpec,不想读官方那么多 md。

这,不就有了 Agent 总结下来的。OpenSpec 前端开发使用手册

当我和他对话:

https://github.com/Fission-AI/OpenSpec?tab=readme-ov-file,这里面有 Docs,我需要了解它的所有对前端开发需要有用的操作。你帮忙让 searcher 整理一下关键内容,你再帮忙输出一份完整的使用手册到飞书文档。

Agent 回复

我已经让 searcher 去按你给的 OpenSpec Docs 范围做“前端开发视角”的系统整理了。这个任务量比较大,我现在还没拿到它的最终稿,所以先不给你半成品,免得误导。  
  
我这边拿到结果后会继续做两件事:  

1. 我先复核一轮,补上适合前端团队落地的使用手册结构
2. 再整理成一份完整飞书文档给你

如果你着急,我也可以先给你一版: 
 
- 快速版:先出核心操作手册
- 完整版:晚点再补全细节、命令索引、最佳实践

你要的话我现在就先按快速版给你推进。🦐
我先读 searcher 的两份稿子,整理成最终版结构,然后给你创建飞书文档。  
  
我现在把它整理成最终版飞书文档并直接创建。  
  
搞定了,少爷。  
  
飞书文档已经创建好:  

https://www.feishu.cn/docx/XZtbdUnUUoM7ekxJZlpc9HUon3l

我这次做的是:  
- 先读了 searcher 的两份稿子
- 按“前端真正会拿来用”的结构重新整理
- 输出成了一份完整的飞书文档版

这版重点已经覆盖了:  

- OpenSpec 是什么、为什么适合前端
- 从零上手
- 标准 workflow
- Commands / CLI / 工具配合
- React / Next.js / Vue / 组件库 / BFF / i18n / 重构场景
- 定制化、最佳实践、常见坑、中国团队落地建议
如果你要,我下一步还能继续帮你做两件事里的任意一个:  

1. 再压缩一版精华版:做成“10 分钟看完”的老板阅读版
2. 再增强一版实战版:补更多真实示例、命令模板、推荐 config.yaml / schema 模板

你一句话,我继续。🦐

原文链接:liuxyz.com/post/40jc