从走进雾区,到看懂 AI 怎样做事
一篇重新学习的起因,四篇用家庭旅行讲清基础概念的图文。
从工作主线看起,再点击一个技能,查看它会使用谁、谁会用到它,以及历史资料有哪些相近方法。每条关系都有中文解释和来源。
打开 53 个 Skills 的交互关系图 →Skill 是什么,
到底怎么用?
先把“文件放在哪里、谁来读取、怎样开始用”讲清楚,再读 Matt 的53篇文档。无需先会编程。
从入门第1课开始 →读53篇之前,先读这6课
基础清楚之后,再读原文
下面保留完整中英对照、详细讲解和问答。第一次学习时,不必从复杂的工程术语开始。
先听老师讲清楚,再对照原文理解。通过问答发现误解,讨论适用场景,最后把方法带入真实工程。
本教材当前版清点到 37 份技能文件:25 份工程与通用技能、8 份实验性技能、4 份专项工具。另从 Git 历史收录 16 个旧名称,组成 53 篇教学目录。它是本教材的编排口径,不是宣称当前仓库有 53 个可安装技能,也不是已经还原文章发布时的完整快照。
当前文件固定于提交 3cca18b368ae95cdbdebbff572ccafa662551015;历史课各自标明真实来源提交。平台累计安装目录、历史名称和当前文件数不能混用。
53 篇保留英文原文,重新撰写中文译文并补充讲解。关键段落后先说明它解决什么问题,再解释概念、推演案例,并说明成立的前提。作者的要求和老师补充的教学内容分开展示。
可以先看你提出的两个例子:跨多个会话开发:规格、工单与清空上下文;测试接入点 seam:从哪里证明功能正确。关于仓库、术语表和 ADR 的解释见 to-spec 第一步。
我们在读什么?
Skill 是 Agent 在特定任务中读取的工作说明。它可能是一段流程、一份判断规则,也可能只是指向其他技能的入口。模型负责理解和推理;工具提供文件、命令或外部系统的操作能力;Skill 帮助组织这些能力。读到“调用工具”不等于当前环境已经拥有那个工具。
阅读开头的 name 与 description,先判断它的名字和职责。再看正文的输入、动作、产物和完成条件。正文若只写“调用另一个技能”,必须沿依赖继续读。脚本和参考文件则可能保存关键实现或分支规则,不能只看宣传简介。
作者区分人工触发与模型可触发技能。当前仓库用 disable-model-invocation 等字段表达这种设计;具体客户端怎样识别,需要在实际使用时核验。这里先学习设计逻辑,不把一个宿主的规则当成所有 Agent 的共同保证。
每课怎样读?
- 读讲解。先抓住它解决的问题,再理解步骤背后的原因。
- 对照原文。直接阅读本页中文译文与对应英文原文,注意版本、依赖与停止条件。
- 自己回答。先不打开参考思路,用自己的话答题,再带回课堂讨论。
- 讨论场景。判断何时使用、何时不必使用;这里的案例用于理解,不要求立即动手。
- 之后实践。基础理解完成后,再选择真实任务验证。阅读完不自动记为掌握。
读作者,也保留判断
作者的经验规则不是普遍定律。例如极简风格的节省比例、特定上下文容量、重构和确认方式,都需要看版本与环境。本教材保留原文,并在“边界与容易误读的地方”解释限制。原文观点、教师解释和教学案例的角色不同,不能混成已经验证的项目结论。
网站提供阅读材料和开放式问题,不会假装已经与您进行了实时问答,也不会自动给出掌握分数。读完后,把课号、自己的回答和不理解的原句带回我们的对话,我再继续讲解与追问。
按理解顺序阅读
前四单元建立主干;实验性和专项技能单独辨认;历史课用于理解旧资料与版本演进。
入门与沟通
从想法到规格
实现与验证
协作与交接
实验性技能
专项工具
历史与演进
每日 4 小时,先保证理解
建议前 90 分钟阅读相关讲义,接着 60 分钟对照原文,45 分钟口头或书面回答问题,最后 45 分钟和老师讨论应用场景。章节难度不同,不按每日固定篇数赶进度;实践安排在理解之后。