Open Skills Logo
Open Skills

writing-plans

在动手写代码之前，当你有多步骤任务的规格或需求时使用

作者

@obra

分类

开发工具

安装

热度:503

下载并解压到你的 skills 目录

复制命令，发送给智能体自动安装：

下载并安装这个技能 https://openskills.cc/api/download?slug=obra-skills-writing-plans&locale=zh&source=copy

writing-plans 技能详情

技能概述

writing-plans 是一个 Claude 技能，用于在编写代码之前创建全面的实现计划，帮助开发者将多步骤任务分解为可执行的 bite-sized 步骤。

适用场景

  • 有多步骤规格说明的项目: 当你有一个完整的特性需求或技术规范文档，需要在开始编码前规划详细的实现路径时，writing-plans 能帮你创建结构化的任务分解。

  • 为零基础团队成员编写指南: 当需要为对代码库不熟悉的工程师、外包开发者或新团队成员提供详细的实现指导时，该技能能确保文档包含所有必要的上下文和步骤。

  • TDD 驱动的开发流程: 如果你希望遵循测试驱动开发（TDD）原则，将每个大任务拆分为"写测试→运行测试→最小实现→再次测试→提交"的循环，writing-plans 是理想选择。

    • 核心功能

  • Bite-Sized 任务分解: 将复杂的开发任务拆分为 2-5 分钟可执行的独立步骤，每个步骤都明确要做什么、怎么做、如何验证是否完成。这种细粒度分解让开发者能快速看到进展，减少认知负担。

  • 文件结构规划: 在定义任务前，先设计清晰的文件边界和接口。技能会帮你确定哪些文件需要创建、哪些需要修改、每个文件负责什么职责，确保代码组织合理、易于维护。

  • 完整任务模板生成: 为每个任务生成标准的任务结构，包括涉及的文件列表、分步骤执行指令（写测试、运行、实现、验证、提交）、完整的代码示例和预期输出，让工程师无需额外上下文即可执行。

    • 常见问题

    writing-plans 和普通技术文档有什么区别？

    传统技术文档通常关注"是什么"和"为什么"，而 writing-plans 生成的实现计划专注于"怎么做"。它假设执行计划的工程师对代码库完全陌生，因此包含每个步骤的完整代码、确切的文件路径、具体的命令和预期输出。每个任务都是自包含的，可以独立完成并验证。

    一个实现计划应该包含哪些内容？

    完整的实现计划必须包含：目标说明（一句话描述要构建什么）、架构概述（2-3 句话说明技术方案）、技术栈、详细的任务列表。每个任务要明确涉及的文件（创建/修改/测试）、分步骤的执行指令（使用 checkbox 语法）、完整的代码示例、具体的运行命令和预期输出、提交命令。计划文档应保存为 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md 格式。

    如何使用 writing-plans 生成的计划？

    在 Claude Code 等支持子代理的 Harness 中，使用 superpowers:subagent-driven-development 来执行计划，每个任务由独立的子代理完成并通过两级评审。在不支持子代理的环境中，使用 superpowers:executing-plans 在当前会话中批量执行计划，并在关键检查点进行评审。每个任务完成后，应该看到明确的成功信号（测试通过、功能验证等）再继续下一个任务。