命令 Pipeline

/dr-plan

创建包含安全分析的详细实施计划

概述

/dr-plan 按照增强设计流程(第 4-6 阶段)生成详细的实施计划——L1-L2 写入任务描述文件,L3-L4 写入 datarim/plans/{TASK-ID}-plan.md。它会解析目标任务,将工作拆解为具体步骤,定义接口,进行威胁建模,为外部工具输出捕获实时夹具,并产出可直接执行的计划。

用法

/dr-plan

功能说明

  1. 任务解析 —— 应用任务解析规则确定正在规划的任务(来自参数,或在多个任务活跃时进行消歧)。
  2. 分析上下文 —— 读取 tasks.md、activeContext.md 以及 datarim/prd/ 中的 PRD 文件。
  3. 战略家门禁(L3-4 强制,且在任何级别下当范围仅为冗余或存在歧义时)—— 评估价值、风险与成本。若战略家建议转向或更廉价的替代方案,则在继续之前提出。
  4. 详细设计(第 4 阶段) —— 组件拆解,列出每个修改和新增文件;接口设计,包含函数签名与 API 契约;数据流追踪;以及安全威胁建模。
  5. 实施计划(第 5 阶段) —— 编写计划正文(L1-L2:datarim/tasks/{TASK-ID}-task-description.md;L3-L4:datarim/plans/{TASK-ID}-plan.md),包含安全摘要、架构影响、详细设计(API、数据库、配置)、实施步骤、测试计划、回滚策略和验证清单。
  6. 技术验证 —— 记录技术栈选型,验证依赖项与构建配置。
  7. 安装器 / 部署脚本审计(当计划涉及 install.sh、同步脚本或部署工具时强制)—— 在目标脚本中 grep 文件类型过滤器,并在计划中列出所有支持的扩展名。若计划引入安装器不处理的扩展名文件,则要么扩展过滤器,要么将该缺口记录为已知限制并添加后续待办项。
  8. 研究淘汰标准检查点(针对比较类任务)—— 在研究之后、机械测试之前,评估仅凭证据是否即可排除候选(已弃用、过时、许可证错误)。未通过淘汰标准的候选将完全跳过测试。
  9. 计划卫生 —— 计划中的所有聚合计数(延迟总数、涉及文件数、威胁数)必须源自源表格并在行内引用。禁止手写汇总数字。
  10. 夹具捕获(当计划解析 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)

相关命令

报告结果

在面向人员的更新或结果之前,应用 Human Outcome Reporting。说明用户可见的结果、原始条件、检查与证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持精确的协议和技术记录完整。若要在不继续工作的情况下再次解释,请使用 /dr-explain。