用途
Vibe Planning Guard 是一个面向 vibe coding 的规划技能，核心目标是在写代码之前，把用户粗略的需求转化为一份经过验证、带选项对比、风险分级明确的实施计划。它默认用户对目标行为只有大致了解，除非工作区能证明相反，因此强调用工作区证据替代自信猜测。
该技能明确只用于规划，不用于编码：在验证门通过之前，不编辑文件，也不把实现标记为可以开始。
主要能力
- 工作区优先取证：先阅读相关代码、配置、测试、schema、文档、提交历史和错误信息，再向用户提问；优先本地检查与可复现命令，而非记忆。
- 证据分级：每个事实、假设和依赖都必须标注为 Primary source、Local reproduction 或 Unproven 之一；只有前两者才能作为事实陈述。
- 行为契约清单：当变更触及既有行为时，按 references/behavior-contract-inventory.md 建立三个桶（即时可观察行为、内部状态转换、持久化/生命周期行为），并逐项标注证据等级。
- 行为等价性分析：按 references/behavioral-equivalence-analysis.md 把每个比较维度分为“在变更范围内”或“必须保持”；若“必须保持”维度不等价则停止并报告，若维度为 Unknown 则阻塞直到提供证据。
- 选项对比：当存在真实设计分支时，比较 2-3 个可行方案，列出权衡、阻塞性未知项和 YAGNI 影响；推荐时把“为什么（已验证事实）”与“为什么（判断）”分开。
- 风险分级与模式选择：提供 light 与 strict 两种模式，按任务规模和风险选择最轻的安全模式。
- 计划边界控制：按 references/plan-boundary-controls.md 执行分类、实现细节例外、仅历史材料折叠、成功标准冻结和计划正文防火墙，并通过完成门。
- 失败模式检查：按 references/failure-pattern-checklist.md 只选取前置条件匹配的章节，并把答案折入事实、阻塞项或测试。
- 恢复检查：对替换、恢复、回滚或重写工作，按 references/change-recovery-checklist.md 先找到最后已知良好提交并检查，再建立历史/当前两列清单。
使用方式
技能按固定工作流推进：
- 先在工作区中定位请求，阅读相关代码、配置、测试、schema、文档、提交历史和错误。
- 选择最小的安全规划切片，把今天可执行的切片与后续阶段分开，把非阻塞或外观性不确定项移入 deferred decisions。
- 当变更触及既有行为时，建立行为契约清单；替换/恢复类工作先执行恢复清单步骤 1-5。
- 写下并冻结当前切片的成功标准；后续新增只有在引用用户需求、新验证来源或“必须保持”维度被判定不等价时才可加入。
- 建立事实表，包含证据等级、来源和影响。
- 显式列出歧义与设计分支，先澄清需求，再在仍有真实分支时比较 2-3 个方案。
- 对每个 Unproven 项记录风险等级（critical/high/medium/low）、影响面（可行性、行为、数据、集成、性能、安全、UX 或外观细节）以及是否阻塞发现、测试设计或实现。
- 对替换/恢复类工作执行残余恢复检查（步骤 6-9）。
- 对适用的高风险面运行失败模式检查，并记录适用性。
- 在实现步骤之前锁定证明检查与测试：发现阶段定义证明检查、spike 退出标准和清除阻塞所需证据；实现阶段定义验收测试、回归测试和重要失败用例。
- 应用计划边界控制与完成门。
- 应用验证门，并用 references/design-exploration-rules.md 做最终自检。
规则优先级依次为：Non-Negotiable Rules、Workflow、Report Structure、Communication Style。
适用场景
- 局部低影响工作（light 模式）：小型重构、聚焦的 bug 修复、单一集成接触点、已知技术栈中的窄范围 UI 变更。使用紧凑报告，工作区扫描后只问 0-2 个会改变计划的问题。
- 多文件或高影响工作（strict 模式）：迁移、重写、行为替换或恢复、外部集成、认证、计费、数据模型变更、性能工作、安全敏感流程，或任何可行性不明确的工作。
- 以下情况立即选择 strict：涉及认证、计费、安全、迁移、外部契约、恢复工作，或存在高/严重 Unproven 项；行为等价性分析含 Unknown 维度，或“必须保持”维度被重新分类为变更范围内；触及共享静态状态、单例、全局事件总线或 hook/订阅者顺序；触及持久化用户配置、缺失字段默认值、退出路径或 schema 迁移；触及构建、打包或发布路径；跨越客户端/服务器或不可信载荷信任边界；触及外部契约、执行顺序、nonce 或重放保护、FIFO 顺序或相对写入的快照时机。
限制
- 该技能只做规划，不编辑文件，也不在验证门通过前授权实现。
- 只要当前阶段仍有一个与实现相关的 Unproven 项，就必须在计划后停止，不得授权实现；必要时缩小当前切片，直到当前阶段零未验证实现假设。
- 风险等级本身不能豁免停止规则；只有“阶段相关性”在当前切片实现步骤之外时才可豁免。
- light 模式不降低验证标准，只减少报告重量并鼓励更紧的范围。
- 若选择处于边界，应选择 strict 并保持报告简洁，而不是削弱安全标准。
- 若发现阶段发现切片选错，应回到第 2 步重启工作流，而不是把清单或冻结套用到不同切片上。
- 若第 10 步或之后出现本应在第 9 步捕获的新测试义务或阻塞项，应回到第 9 步重启，而不是就地修改测试。
- 资料未提供该技能的具体安装命令、收费方式、支持平台或运行环境要求。