intent.md 是什么：Anthropic 的 AI-Native SDLC

intent.md 的价值不在文件名，而在于它把意图从对话里抽出来，变成下一段 agent 不需要继承上下文也能执行的审计记录

本文综合：Rob Shocks 把 Anthropic 的 AI-native SDLC 讲成一条 artifact chain——intent.md → spec.md → plan.md → diff/PR → 生产监控再写回 intent.md（00:02:14–00:02:42；00:13:47–00:15:10）。官方 playbook 把同一件事写得更硬：每个阶段结束时必须提交一份下一阶段能读的 artifact，commit 链就是审计轨迹；人仍然对需要判断的决定负责，只是注意力从“从头写”挪到“在门上签字”。https://claude.com/blog/the-ai-native-sdlc-playbook 因此，intent.md 不是又一个 markdown 习惯，而是在代码已经不再是瓶颈之后，把规划、审查、部署这些仍按人类速度运行的步骤，改成机器可交接、人类可追责的接口。

TL;DR

两分钟读完

下面把节目时间戳、Anthropic 官方文档和本文综合分开写。未标注 URL 的句子默认来自视频字幕。

一句话

Anthropic 把 SDLC 从线性交接改成由版本化 artifact 驱动的闭环；intent.md 是这个闭环的入口，Rob Shocks 用 16 分钟说明普通团队可以从哪几段先落地。

节目主张：agent 已经把构建阶段压短，Anthropic 说“我们快了两倍”，真正的问题是规划、测试、部署、维护仍按人类速度运行（00:00:26–00:01:21）。
官方定义：intent.md 是 originator 用自己的话写下的 proto-spec，至少包含问题、期望结果、受影响的人与系统、约束和未决问题；product owner 审改后再提交。https://academy.claude.com/courses/ai-native-sdlc-playbook/capture-intent
下一段不是人再写一份 PRD，而是用 skill 约束一次会话，把 intent.md 压成 spec.md，再在 plan mode 里得到可独立执行的 plan.md（00:04:26–00:08:24；官方 Design / plan mode 课）。
测试与部署要把确定性检查前移：agent 先跑测试/lint/截图，evals 回归 skill 与模型变更，PR 由另一实例审查，hooks 卡住未授权的生产动作（00:11:04–00:13:49）。
维护是闭环而不是值班：越界、工单或频道消息可以无人工启动 Claude，诊断结果写成新的 intent.md，但检测本身应保持确定性（00:13:47–00:15:10；官方 Stage 6）。
节目自己的限定：没有一刀切；已有 Superpowers、BMAD 或自研流程不必整套替换（00:15:36–00:16:21）。

THE ARGUMENT

整期内容的一条主线

把官方 playbook 和这期讲解叠在一起，主线可以写成五步：

STEP 01

构建不再是约束

传统 SDLC 为“写代码最贵”而设计；agent 把构建压短之后，瓶颈移到规划、审查/测试和部署，手审每一行 diff 跟不上。节目用“快了两倍”概括这一点（00:00:52–00:01:21）。官方原文是：human-speed stages keep their length while build collapses。https://claude.com/blog/the-ai-native-sdlc-playbook

STEP 02

先把意图写成可交接的 artifact

originator 与 Claude 头脑风暴，产出 intent.md；任何人都可以当 originator，但 product owner 负责 backlog 审阅（00:02:14–00:04:29）。官方把模板写死为 Problem / Proposed outcome / Affected users and systems / Constraints / Open questions，并把接受或拒绝记进 git。https://academy.claude.com/courses/ai-native-sdlc-playbook/capture-intent

STEP 03

下一阶段只读上一份文件，不继承对话

节目强调独立 agent 和有限 context window，所以要把 intent 与 spec 作为文档交接，plan.md 要写到“没看过对话的工程师也能实现”（00:07:03–00:08:24）。官方同样要求：accepted intent.md 触发 design，approved spec.md 触发 plan mode。https://academy.claude.com/courses/ai-native-sdlc-playbook/plan-mode

STEP 04

把能确定的部分变成 hooks、测试和 evals

构建阶段用权限、hooks、lint、worktree 和 auto mode 加快执行；测试阶段让 agent 在人看到之前自检；skill 或模型变更要跑连续 evals（00:08:47–00:12:28）。官方补了一句节目没说清的话：skill 是建议性控制，必须守住的政策要有 hook 或审查关卡。https://academy.claude.com/courses/ai-native-sdlc-playbook/skills-as-institutional-knowledge

STEP 05

人留在门上，回路自己转起来

PR 审查、release gate 和生产监控把人从启动者变成签字者：agent 可以诊断、开 PR、写新的 intent.md，但不能自己批准上生产（00:12:26–00:15:37）。官方收束为：The loop keeps running. Human judgement stays above it。

DEEP DIVE

内容提炼

以下主题按节目时间排列。每条尽量标明：节目证据、官方补充、本文综合。

0100:00–00:01

代码不再是瓶颈，流程才是

观察主张

Rob Shocks 用六段 SDLC 开场：plan、design、build、test、deploy、maintain。他说 Anthropic 的大判断是：agent 出现前最贵的是构建；现在构建被压短，真正要改造的是两侧仍按人类速度运行的步骤。

节目：构建曾经最长、最贵；agent 把它压短后，Anthropic 的问题变成“其余步骤怎么同样用 agent 改进”（00:00:52–00:01:21）。
官方：瓶颈移到 plan、review/test、deploy；手审每一行在 agent 写大多数 diff 时变得不可行；治理成本上升，因为例外仍要等每周或每月的委员会。https://claude.com/blog/the-ai-native-sdlc-playbook
官方举例：安全团队按人类产量定编，agent 放大代码产出后，要么审查队列堆积，要么代码审查不足；受监管组织两种都不能接受。

先承认构建已经变快，再决定把人类注意力放在哪些门上，而不是继续用旧的审批节奏去追 agent 的产出。

0200:01–00:04

intent.md：把痛点写成双读者 proto-spec

主张观察

规划不再从工作坊和 PRD 开始，而是让 agent 反复采访 originator，把领域经验和约束写进 intent.md。这份文件既给人读，也给下一阶段的 agent 执行。

节目：agent 直接从来源综合痛点，写入“human-readable and machine-actionable”的 intent.md；传统路径则是 backlog、user stories、story points 和所有权交接（00:01:47–00:02:16）。
节目实践：在仓库建 intent/ 文件夹；他用 dark mode 当例子，并强调工作流要标准化、不要改得太勤（00:02:40–00:03:35）。
官方模板把字段写死：Problem、Proposed outcome、Affected users and systems、Constraints、Open questions；示例是理赔状态自助查询。https://academy.claude.com/courses/ai-native-sdlc-playbook/capture-intent
官方执行顺序：originator 用自己的话描述问题 → Claude 像分析师一样追问 → 按组织模板写成 intent.md → originator 纠正误解 → 提交到共享位置，作者和时间戳进入记录。
本文综合：文件名可以叫 discovery.md，节目也承认自己课程里就这么叫；关键是字段稳定、人机都能接着用，而不是 markdown 本身。

intent.md 要回答的是要什么、为什么、受什么约束、还有什么没决定；它不是另一份更短的 PRD。

0300:03–00:05

originator 谁都可以，签字的是 product owner

主张观察

创建意图的人不需要是专家：客户报缺陷、产品经理提功能、开发者记流程改进都可以。但这些文件要进入 backlog，由 product owner 审，而不是直接开工。

节目：originator 必须回头核对 agent 写的内容；随后由 product owner 以 backlog 审阅，材料可以是排序过的 markdown，也可以进 Notion 或 Linear（00:03:06–00:04:29）。
节目补充：agent 可以给 backlog 打标签，例如前端、大小、是否功能、优先级（00:04:26–00:04:53）。
官方：无论意图来自人、工单还是告警，product owner 都要在提交前审改 agent 写的 intent.md；接受或拒绝记为 merge 或关闭 review。https://academy.claude.com/courses/ai-native-sdlc-playbook/capture-intent
官方指标：从第一次对话到提交 intent.md 的时间应从数周降到数小时；滞后指标是被 product owner 接受进入 Design 的存活率，以及 spec.md 提交后 intent.md 仍被改动的次数。

降低意图入口的门槛，和提高签字门槛，是同一件事的两面。

0400:04–00:06

从 intent 到 spec：一次会话，而不是两支团队

主张观察

intent 被签字后，下一份 artifact 是 spec.md。节目给出 Anthropic 的示例 prompt，并强调用 skill、政策或 agents.md 把组织规范编进去。

节目：Anthropic 建议 intent 提交后用 hook 或流程自动生成 spec；示例 prompt 是阅读 intent.md、产出 requirements and design spec、应用 skill 以符合品牌规范，并写成 spec.md（00:04:26–00:05:19）。
节目限定：没有一刀切，可以用原版 plan mode，也可以做符合团队习惯的 skill；治理约束适用于整条 artifact chain（00:05:16–00:06:13）。
官方更细：product owner 打开带组织 skill 的会话、附上 intent.md，要求标出冲突；先手跑，再做成 slash command，最后让 intent 被接受时自动提交 spec.md PR。product owner 审 spec，但不亲手写。https://academy.claude.com/courses/ai-native-sdlc-playbook/requirements-and-design
官方：前端 clearest path 是用 Claude Design 从 intent.md 出 mock，再导出到 Claude Code；政策冲突应在 spec 阶段由政策负责人解决，而不是等几周后的审查才发现。

自动生成 spec 之前，先有一份被签字的 intent，以及一套版本化的组织 skill；否则自动化只会更快地传播误解。

0500:07–00:09

plan.md：跨 context window 的可执行交接

主张本文综合

工程师把 intent 和 spec 喂进 Claude Code 或 Cursor 的 plan mode，得到 plan.md。节目认为计划必须写到：没看过先前对话的工程师也能实现。

节目：质询计划时要问哪些改动可能弄坏现有系统；因为不会让同一个 agent 跑完整条 SDLC，独立 agent 必须从文档冷启动（00:07:03–00:08:24）。
节目归纳 Anthropic 的计划结构：要改的文件、工作顺序、风险与约束、proof（成功标准和检查，可以是 lint 与测试）（00:07:55–00:08:49）。
官方：plan mode 里 Claude 先读代码、不改文件；工程师接受前不能实现。计划要问：可能弄坏什么、哪一步最险、Claude 放弃了哪些方案。https://academy.claude.com/courses/ai-native-sdlc-playbook/plan-mode
官方：实现偏离计划时，应在同一次 commit 更新 plan.md；PR review 会拿 diff 对照这份计划。
本文综合：plan.md 的读者不是“当时那次聊天”，而是下一个 context window 和未来的审查者。

如果 plan.md 仍依赖聊天记忆才能执行，artifact chain 在这一环已经断了。

0600:08–00:11

auto mode、权限、hooks 与 worktree

主张观察

要让构建阶段在人少介入时仍可控，节目把 Anthropic 的 auto mode 和自己的实践叠在一起：先锁权限和 blast radius，再用 hooks 与 worktree 做并行。

节目：保存 intent/spec/plan 的版本、谁动过、如何演化，才能追踪领先/滞后指标并证明 DORA（00:08:22–00:09:16）。
节目：auto mode 取决于组织；先在仓库里调好工具、网页来源和包权限，才能让 agent 在你不盯着时加快（00:08:47–00:09:44）。
节目中的 hooks 例子：实现完成后更新 plan、阻止改某些文件夹、阻止操作未签字的 npm 包；lint 提供二元的确定性检查（00:09:42–00:10:38）。
官方：auto mode 在 CLAUDE.md、skill、hooks 和可运行测试套件成熟后，才适合作为常规工作的默认；人从盯每一次编辑，转为审查更长自主会话后的 artifact。https://academy.claude.com/courses/ai-native-sdlc-playbook/plan-mode
官方：skill 只是建议；必须始终成立的政策要靠 hook 拦截，或在 PR 再检查。构建期 hook 应快、只针对改动文件。https://academy.claude.com/courses/ai-native-sdlc-playbook/skills-as-institutional-knowledge

先收紧权限和确定性护栏，再打开 auto mode；否则速度会变成不可审计的扩散。

0700:11–00:12

测试前移，evals 看守配置而不是只看守代码

主张观察

传统测试常卡住交付：人做完后等 QA 数天。AI-native 路径是让 agent 在人类工程师或 QA 靠近前，尽量完成测试、lint、构建，甚至用浏览器截图。

节目：agent 写测试并让它们通过，lint 并构建；进阶做法是 Playwright、TDD、Cursor Browser，让 agent 拉起服务器、截图甚至给屏幕录像（00:11:04–00:12:01）。
节目承认自己的图和 Anthropic 方案略有偏差，来源是 Switch Dimension 课程，但结构相近（00:11:04–00:11:34）。
节目：skill 变更或模型升级要跑 evals；收集约 20 个已解决事项及其期望结果，在 CI 里看 SDLC 有没有回退（00:11:59–00:12:28）。
官方：evals 是 AI-native 的阶段门 QA，应在 CLAUDE.md、skill、hooks 变更时跑；建议收集 20 到 50 个真实任务；生产事故应变成永久 eval。https://academy.claude.com/courses/ai-native-sdlc-playbook/continuous-evals-in-ci
官方还要求保护反馈回路：修缺陷时用 hook 禁止 agent 改测试文件，避免它通过削弱检查来“通过”。https://academy.claude.com/courses/ai-native-sdlc-playbook/give-claude-a-feedback-loop

人要审的是意图和风险；机械证据应在人看见之前，由测试、截图和 evals 先给出。

0800:12–00:14

PR 审查与部署门：agent 做到门口，不能自己进去

主张观察

部署阶段，agent 开 PR，另一个 Claude 实例按政策和安全协议异步审查；hooks 可以要求特定权限、特定的人或 release gate，否则阻止部署。

节目：开发分支与生产分支分离；agent 在自己的分支或 worktree 上改完后开 PR，请人把改动并入主库（00:12:26–00:12:55）。
节目：CI 或每次 PR 都让 Claude 对照政策与安全协议审查；另一个独立 Claude Code 实例处理这些评论（00:12:53–00:13:21）。
节目：hook 可在未获授权时挡住部署；PR 完成后还可以再跑安全检查、CI preview，以及 Cursor Bugbot 或 Claude security review（00:13:19–00:13:49）。
官方：REVIEW.md 规定 Bugs / Security / Compliance 三轮，并对照 spec.md 与 plan.md；发现本身不批准 PR，branch protection 仍要 code owner。写代码的 agent 没有批准路径。https://academy.claude.com/courses/ai-native-sdlc-playbook/ai-in-the-pr-review-loop
官方：hook 可以 allow / ask / block；不可谈判的门应放进 managed settings，工程师关不掉。https://academy.claude.com/courses/ai-native-sdlc-playbook/hooks-as-approval-gates

审查自动化之后，人的工作变成判断“这件事该不该进生产”，而不是把 diff 当小说读完。

0900:13–00:16

维护把回路闭合：越界结果写成新的 intent.md

预测主张本文综合

Rob 认为维护是整条工作流里最有雄心的一段：告警、工单、Slack 消息或定时任务可以在无人启动的情况下唤醒 Claude，让它根据日志写出新的 intent.md。

节目：传统维护是被动的，凌晨三点告警、工单在 backlog 里被忽略；AI SDLC 里越界或消息会异步唤醒 Claude 去诊断（00:13:47–00:14:44）。
节目实践图景：页面挂掉或 API 限流飙升时，agent 在你坐到电脑前先诊断、写 intent、给建议（00:14:41–00:15:10）。
节目收束：减少每一步的人类时间，但在重要审查步骤把人留在回路里；低关键性才可以几乎只靠 agent（00:15:08–00:15:37）。
官方把检测和行动分层：检测脚本必须完全确定性、不经过模型；1σ 只记日志，2σ 只读诊断，3σ 才能经门控开 PR 或触发预先批准的 runbook。https://academy.claude.com/courses/ai-native-sdlc-playbook/closing-the-loop-on-metrics
官方还有节目未展开的一层：定期安全扫描和 Claude Tag 值班，较大发现同样写成 intent.md，小修复走 PR 门。https://claude.com/blog/the-ai-native-sdlc-playbook
本文综合：如果没有确定性越界检测和预先批准的行动边界，所谓自主运维只是把 on-call 换成了无人看管的 agent。

闭环成立的条件是：检测不靠模型，行动必须过门，结果重新变成 intent.md。

OPEN QUESTIONS

尚未解决的张力

节目是 16 分钟导览，官方 playbook 面向大型、尤其是受监管企业。两者叠在一起，有几处没有被这期视频收住。

企业 playbook 与“没有一刀切”之间的距离

官方课程写明对象是已经在用 Claude Code、且审批仍按人类速度运行的工程/平台/安全负责人，尤其是不能让审查队列堆积的受监管组织。VS节目结尾说没有一刀切，已有 Superpowers、BMAD 或自研流程不必整套替换，plan mode 或 vibe coding 也可以是起点（00:15:36–00:16:21）。

两者并不必然冲突，但视频没有说明：哪些 play 可以单独采用，哪些在缺少 branch protection、managed hooks 和 evals 时会失效。官方自己也说 plays 模块化、依赖图画在“Prerequisites”里；视频把整条链讲成一次导览，容易让人以为要一次换完。

自动生成 spec 与 product owner 仍要解决政策冲突

节目把 Anthropic 的建议概括为：intent 签字后用 hook 或流程自动生成 spec（00:04:26–00:04:53）。VS官方要求 product owner 审 spec、先处理 flagged concerns，并与政策负责人解决冲突，然后才进入 plan mode。https://academy.claude.com/courses/ai-native-sdlc-playbook/requirements-and-design

自动化交接解决的是手写损耗，不是判断本身。如果团队只实现“intent 一合并就出 spec”，却没有人处理互相矛盾的安全/品牌/UX 约束，冲突会从需求会转移到生成出来的 spec.md 里。

减少人类时间，与人必须留在门上

节目反复问：怎样减少每一步的人类时间，并展示 auto mode、并行 worktree、agent 自测和无人启动的维护（00:08:47–00:15:37）。VS官方反复写：人仍对需要判断的决定负责；写代码的 agent 不能批准自己的 PR；生产门由具名发布授权挡住。https://academy.claude.com/courses/ai-native-sdlc-playbook/ai-in-the-pr-review-loop

视频把“人在回路”说成重要审查步骤，但没有给出门的清单。官方的门更具体：intent 接受、spec 接受、plan 接受、code owner、release authorization。缺省其中任何一扇门，速度主张都会变成责任空隙。

git 里的 markdown 与已经存在的审计系统

节目默认 artifact 是仓库里的 markdown 文件夹，并可用 Notion 或 Linear 做 backlog（00:02:40–00:04:29）。VS官方用整节讨论遗留系统：Jira、带监管追溯的需求工具、Figma、变更委员会很难被替换；必须为每类 artifact 指定唯一真相源，其余只保存副本或链接。https://academy.claude.com/courses/ai-native-sdlc-playbook/plan-mode

这期视频面向个人开发者和小团队，几乎不处理审计员已经接受的系统。对受监管组织，intent.md 若不能回写到现有记录，playbook 无法落地；对小团队，先上 Jira 同步又可能是过度设计。

讲解压缩造成的命名与数量偏差

字幕和讲解出现 agents.md、约 20 个 eval 用例、以及“hook 自动生成 spec”等压缩说法（00:05:44–00:06:13；00:11:59–00:12:28）。VS官方主文件是 CLAUDE.md，skill 在 .claude/skills/，evals 建议 20 到 50 个真实任务，并且应在配置变更时作为回归套件运行。

这些偏差不否定主线，但说明不能把这期视频当实施手册。实施应以官方 playbook 和 Academy 课为准，视频只负责建立直觉。

SO WHAT

可执行启示

下面的动作把官方 playbook 收成可执行的最小切片；先做入口和门，再做自主维护。

产品负责人 / 意图 originator

约定一份 intent.md 模板，字段至少包括问题、期望结果、受影响的人与系统、约束、未决问题；originator 必须在提交前改正 Claude 的误解。
把 intent 放进 product owner 能看到的共享位置（产品仓库的 intent/ 即可），接受或拒绝都留下 git 记录，而不是只留在聊天里。
intent 被接受后，用同一套组织 skill 生成 spec.md，并先处理 flagged concerns，再交给工程进入 plan mode。

工程师

默认从 plan mode 开始：把 intent.md 与 spec.md 交给 Claude，质询可能破坏点、最险步骤和被放弃的方案，直到 plan.md 可独立执行。
实现偏离计划时，在同一次 commit 更新 plan.md；不要让聊天记忆成为真正的计划。
给会话一条可失败的验证命令（测试、构建或截图对比），并在修缺陷时禁止 agent 改测试文件。

平台 / 工程效能

先写 1 到 2 个必须守住的政策为 skill，并给它们配上 hook；skill 只负责提醒，hook 负责拦住。
在 CLAUDE.md、skill 或 hooks 变更时跑 20 到 50 个真实任务的 evals；生产事故要变成永久回归用例。
用 REVIEW.md 规定 Bugs / Security / Compliance 三轮审查，发现不批准合并；branch protection 仍要 code owner。

技术管理者 / 发布负责人

列出必须保留的人类批准门（变更授权、生产发布、受保护路径），把不可谈判的门放进 managed settings。
自主维护从一条有稳定基线的指标开始，检测保持确定性：1σ 记录、2σ 只读诊断、3σ 只能开 PR 或跑预先批准的 runbook。
用领先/滞后指标看流程是否真的变快：intent 提交时间、spec 返工、首次实现即合并的比例、越界到新 intent.md 的时间；不要只报生成代码量。

CHAPTERS

节目时间轴

对照 Rob Shocks 的 16 分钟讲解和 Anthropic 官方 playbook：intent.md 不是新文件格式，而是把“要什么、为什么、受什么约束”写成下一阶段能直接执行的版本化 artifact