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

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

基本信息

• 技能名称?Writing Plans
• 中文名称?零上下文工程师的精确实施蓝图
• 作者?zlc000190
• 分类?其他
• 版本?0.1.0
• 标签?tdd, implementation-planning, onboarding, documentation, subagent-orchestration, agile

使用方法

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