核心用法
writing-plans skill 是一种计划先行的工程方法论工具,用于在多步骤开发任务开始前,为假设零上下文的工程师生成完整的实施蓝图。其核心流程包括:在独立 worktree 中运行 → 解析需求/规格说明 → 输出结构化 Markdown 计划文档 → 提供两种执行路径选择(本会话子代理驱动 / 新开会话并行执行)。
显著优点
1. 认知卸载彻底:假设执行者" skilled but clueless",强制文档化所有隐含上下文(文件路径、依赖、测试策略),显著降低知识传递成本
2. TDD 内建:每个任务拆解为"写失败测试→运行确认→实现→验证→提交"的 2-5 分钟原子单元,将测试驱动开发固化为流程
3. 执行路径灵活:支持子代理逐任务迭代(适合复杂/高风险功能)或批量并行会话(适合确定性高的任务),兼顾质量与效率
4. DRY/YAGNI 原则锚定:文档头部强制声明架构取舍,避免过度设计
潜在局限与风险
- 计划刚性成本:高度细粒度的计划可能在探索性开发中成为束缚,适合需求明确的任务,对高度不确定的 R&D 场景可能过度约束
- 维护负担:计划文档与代码双轨维护,若执行中大幅调整,计划文档易沦为"过期设计文档"
- 工具链依赖:深度绑定特定子代理系统(superpowers:executing-plans / subagent-driven-development),跨平台迁移成本未知
适合人群
分布式团队的技术负责人、需要严格代码审查流程的合规场景、新成员 onboarding 时期的高风险模块开发。
常规风险
- 路径漂移:执行者偏离计划却不更新文档,导致计划-执行断层
- 过度计划化:将本可 30 分钟完成的简单任务包装为 10 步计划,产生仪式化 overhead
- 权限边界:子代理驱动的执行模式需明确文件系统/网络访问权限,避免计划中的命令意外越权