用途
sdlc-plan 用于把一个新产品变更记录成单页 intent.md，写作用户的原话。这一页既是双方达成的约定，也是后续执行时被对照检查的清单。
主要能力
- 撰写 intent/<slug>/intent.md，内容包含 Problem、Outcome、Acceptance、Approach、Out of scope、Steps，critical 级别另含 Spec 与 Result。
- 分流判断：可行性问题属于 spike，只回答，不写 intent；现有流程中的缺陷、微调或小型行为变更属于 sdlc-fix，不写 intent；凡改变产品行为的都属于 intent。
- 分级：change 为普通功能，一个 intent 文件后即可构建；critical 为后果性变更（有数据表的迁移、认证、密钥、隐私或 PII、破坏性或不可逆操作、会改变生成内容或审批的 LLM 提示或门禁、对外发送、抓取策略），需在同一文件追加 ## Spec 章节并接受更严格评审，缺少独立评审者会阻断流程。不确定时按 critical 处理。
- 两个级别在 apply 之后都会进行全新上下文的 sdlc-verify。
规则要点
- 保留用户要求的结果：明确要求的自动化、指定的提供商或集成、要求的数据覆盖都属于需求；手动兜底或后续跟进不满足这些需求；未经用户明确同意，不得把用户要求的内容移入 Out of scope。
- 不擅自增加范围：新增界面、强制输入、确认或门禁属于产品决策，必须能追溯到用户的要求，否则先呈现权衡由用户决定。
- 规模贴合用户：面向一个人、一次部署，不做投机性设置或扩展点。
- critical 的 ## Spec 只解决代价高昂、容易做错的决策，并引用所读代码：契约及其调用方；数据与迁移（只做加法、不改已应用的迁移、如何用填充了前一状态的一次性数据库证明升级可用）；失败、重试与重新加载后的持久状态；基于真实适配器或版本匹配文档的提供商错误；认证、密钥、PII 以及离开本机的内容；发布与回滚；待定决策，每项由用户回答或采用其接受的默认值。不重复 Acceptance 内容。
- Acceptance 覆盖缺陷隐藏的边界：对状态型、异步或外部提供商的结果，补充被拒、过期、失败、重试与重新加载等情形。
- 按信心度挑战：高表示结果与约束明确、现有源码支持该方案、契约与失败模式有证据、没有未决假设，此时继续推进；否则交给一名全新的只读评审者处理最强的未决假设，核对其引用并记录变更。已确定的决策不再重复挑战。
- 宽泛请求需拆分：指出第一个可独立使用、完整的交付并写成 intent，其余作为列表放在 Out of scope 或留作后续 intent。
使用方式
- 阅读仓库的说明与 intent/*/ 查看进行中的工作。先读代码，再问代码能回答的问题。
- 访谈直至具体：今天做不到什么、其真实性的证据（或 not checked）、谁受影响、更好的状态是什么、约束、范围外内容。一次只问一个问题，且仅当答案会改变要构建的内容时提问；否则说明假设并继续。
- 阅读将要改动的代码，据此撰写 ## Approach：变更路径、复用的内容、刻意不构建的内容，以及每项决策及其理由。用户在此处、在构建之前发现过度构建；自动运行会利用这些路径发现 intent 之间的重叠。
- 选择一个在 intent/ 中未使用过的 kebab-case slug。按模板创建 intent/<slug>/intent.md。
- 展示路径与简短摘要。用户接受或修正。接受后置 status: accepted 并提交该文件。之后对成果或验收的实质性变更需重新置回 draft，直到再次被接受。
- 下一步：sdlc-apply。一次验收覆盖 intent，对 critical 而言还覆盖其 Spec。
模板
status: draft # draft | accepted tier: change # change | critical slug: example-slug
Intent: short name
Problem
今天做不到什么，谁感受到。其真实性的证据，或 not checked。
Outcome
更好的状态是什么，可观察，用用户的话。保留简短有力的原话引用。
Acceptance
- WHEN <trigger> THEN <observable result>。每行一条，每条可核查。精确引用限制与枚举值。
Approach
变更路径。复用的内容。刻意不构建的内容。所做的决策，每行一条并附理由。不超过 8 行。
Out of scope
仅包含用户同意排除的内容。
Steps
- [ ] 第一个连贯切片。check: 如何知道它可用
- [ ] ...
Spec（仅 critical）
契约与调用方。数据与迁移。失败与重试。安全与隐私。发布与回滚。待定决策。
Result
在最后填写：每条 Acceptance 一行（PASS/FAIL、证据），以及任何未检查项。
适用场景
适用于用户提出新能力或产品变更、需要先把意图写成单页文档并据此验收的场合；也适用于把宽泛请求拆成第一个可独立交付的切片。
限制
关于具体收费、价格、平台支持情况与执行效果，当前资料未提供。技能本身要求不凭空增加范围、不做投机性扩展，规模按一人一次部署来把握。