Writing Plans

🗺️ 零上下文工程师的精确实施蓝图

软件工程/开发方法论榜 #1

为工程师生成可执行的细粒度实施计划文档,涵盖TDD、文件路径、测试命令与提交策略,降低跨团队协作的认知摩擦。

收藏
20.1k
安装
6.4k
版本
0.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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
  • 权限边界:子代理驱动的执行模式需明确文件系统/网络访问权限,避免计划中的命令意外越权

Writing Plans 内容

暂无文件树

手动下载zip · 1.8 kB
contentapplication/octet-stream
请选择文件