/dr-plan
创建包含安全分析的详细实施计划
概述
/dr-plan 按照增强设计流程(第 4-6 阶段)生成详细的实施计划——L1-L2 写入任务描述文件,L3-L4 写入 datarim/plans/{TASK-ID}-plan.md。它会解析目标任务,将工作拆解为具体步骤,定义接口,进行威胁建模,为外部工具输出捕获实时夹具,并产出可直接执行的计划。
用法
/dr-plan
功能说明
- 任务解析 —— 应用任务解析规则确定正在规划的任务(来自参数,或在多个任务活跃时进行消歧)。
- 分析上下文 —— 读取
tasks.md、activeContext.md以及datarim/prd/中的 PRD 文件。 - 战略家门禁(L3-4 强制,且在任何级别下当范围仅为冗余或存在歧义时)—— 评估价值、风险与成本。若战略家建议转向或更廉价的替代方案,则在继续之前提出。
- 详细设计(第 4 阶段) —— 组件拆解,列出每个修改和新增文件;接口设计,包含函数签名与 API 契约;数据流追踪;以及安全威胁建模。
- 实施计划(第 5 阶段) —— 编写计划正文(L1-L2:
datarim/tasks/{TASK-ID}-task-description.md;L3-L4:datarim/plans/{TASK-ID}-plan.md),包含安全摘要、架构影响、详细设计(API、数据库、配置)、实施步骤、测试计划、回滚策略和验证清单。 - 技术验证 —— 记录技术栈选型,验证依赖项与构建配置。
- 安装器 / 部署脚本审计(当计划涉及 install.sh、同步脚本或部署工具时强制)—— 在目标脚本中 grep 文件类型过滤器,并在计划中列出所有支持的扩展名。若计划引入安装器不处理的扩展名文件,则要么扩展过滤器,要么将该缺口记录为已知限制并添加后续待办项。
- 研究淘汰标准检查点(针对比较类任务)—— 在研究之后、机械测试之前,评估仅凭证据是否即可排除候选(已弃用、过时、许可证错误)。未通过淘汰标准的候选将完全跳过测试。
- 计划卫生 —— 计划中的所有聚合计数(延迟总数、涉及文件数、威胁数)必须源自源表格并在行内引用。禁止手写汇总数字。
- 夹具捕获(当计划解析 CLI / 子进程 / API 响应时强制)—— 在
/dr-plan期间捕获真实样本并提交至datarim/tasks/{TASK-ID}-fixtures.md。优先使用机器可读输出(--json、--output-format stream-json)而非解析人类文本。
CLI 智能体退出码模式
许多 CLI 智能体(Claude Code、Cursor,可能还有 Gemini/Codex)即使 JSON 输出包含 is_error: true 也返回退出码 0。捕获夹具时,务必同时捕获成功和错误用例。解析器必须检查 JSON 中的 is_error/subtype,而不能依赖退出码。
参数
无。作用于当前活跃任务(通过任务解析确定)。
输出
将计划写入 datarim/tasks/{TASK-ID}-task-description.md(L1-L2)或 datarim/plans/{TASK-ID}-plan.md(L3-L4);datarim/tasks.md 仅保留一行指针。可能创建:datarim/tasks/{TASK-ID}-fixtures.md。
计划结构
计划包含:概述、安全摘要(攻击面、风险)、架构影响、详细设计(组件、API、数据库)、安全设计(威胁模型、控制措施)、实施步骤、测试计划(单元/集成/安全)、回滚策略、验证清单以及后续步骤。
过渡检查点
在进入下一阶段之前,验证:
- 需求已清晰记录
- 组件与受影响文件已识别
- 安装器/部署脚本内容类型审计已完成(如适用)
- 若计划解析任何外部工具输出,已捕获实时夹具
- 所有聚合计数均源自源表格(非手写)
- 完成定义可测试且明确
- 已声明边界(我们不做什么)
- 技术栈已验证
- 回滚策略可行
示例会话
> /dr-plan
任务解析:<TASK-ID>(级别 3)
读取上下文...
PRD:PRD-authentication.md
战略家门禁:
价值:高(核心功能,阻塞其他 3 个任务)
风险:中(OAuth 复杂性、令牌管理)
成本:预计 2-3 天
结论:按计划继续
夹具捕获:
已捕获:Claude CLI 成功 + 错误输出
已保存:datarim/tasks/<TASK-ID>-fixtures.md
注意:两种情况退出码均为 0 —— 解析器使用 is_error 字段
生成计划...
组件:8 个文件(4 个新增,4 个修改)
API 端点:5
数据库迁移:2
测试用例:14
计划已写入 datarim/plans/<TASK-ID>-plan.md
下一步:/dr-design(L3-L4;L1-L2 转至 /dr-do)
相关命令
- /dr-prd — 上一阶段:需求
- /dr-design — L3-4 的深度设计探索
- /dr-do — 下一阶段:实施
报告结果
在面向人员的更新或结果之前,应用 Human Outcome Reporting。说明用户可见的结果、原始条件、检查与证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持精确的协议和技术记录完整。若要在不继续工作的情况下再次解释,请使用 /dr-explain。