用途:在已有多步骤任务的规格或需求、但尚未开始写代码时使用,产出工程师可逐条执行的实施计划。计划默认保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md,用户偏好可覆盖该路径;应在专用 worktree 中运行,开始时声明正在使用 writing-plans 技能。
主要能力:先做范围检查,多子系统规格建议拆成独立计划,用户可见功能按垂直切片(UI、API、业务逻辑、数据、测试)规划,bugfix/重构只覆盖实际涉及层;先定义文件结构,明确每个文件职责与接口;任务按 2-5 分钟粒度拆分,每一步是单一动作:写失败测试、运行确认失败、写最小实现、运行确认通过、提交,并给出确切文件路径、完整代码和带预期输出的确切命令。计划中显式落实 DRY、SOLID、YAGNI,并遵循 TDD 和频繁提交。
安全:若功能跨越信任边界(认证授权、不可信输入、敏感数据、新端点或外部集成、反序列化等),需先运行 /cso 做威胁建模,把每项实质威胁转成独立设计任务和负向测试;不跨边界则一行说明即可,不额外制造安全任务。
必备章节与流程:每个计划必须以 ## Test Plan & Verification 结尾,包含具体覆盖率目标、关键路径、边界与错误路径、回归保护、验证命令和验收标准;随后自检规格覆盖、占位符、类型一致性、TDD 与测试计划完整性、原则与信任边界,再自动调用 /plan-eng-review 做第二遍工程评审,将结果回填计划。完成后提供执行选择:子代理驱动(推荐 subagent-driven-development)或会话内 executing-plans,资料未提供具体安装命令。