# 编写实现计划 (writing-plans)

> 把需求或规格写成面向陌生工程师的实现计划，拆成带文件、接口和测试的小任务。

- 分类: [任务拆分](https://www.myskills.tools/zh/categories/task-breakdown/)
- 来源: 社区 · Jesse Vincent
- 代码仓库: https://github.com/obra/superpowers/tree/main/skills/writing-plans (commit 8ca22db)
- SKILL.md: https://github.com/obra/superpowers/blob/main/skills/writing-plans/SKILL.md
- 安装命令: `npx skills add obra/superpowers --skill writing-plans`
- 许可证: MIT
- 兼容工具: Claude Code, Codex, Cursor, Gemini CLI, OpenCode
- 权限: read-repo ✓, write-files ✓, shell ✗, network ✗
- 状态: 扫描通过
- 规则扫描无法覆盖所有风险，安装前请阅读此技能的 SKILL.md，确认权限后再使用。

## 核心规则

每一步都必须让实现者只能写出一种合理的东西，既不留空白，也不替他把代码写完。

## 执行阶段

1. **检查范围** — 若规格涵盖多个独立子系统，建议按子系统拆成多份计划，每份都能产出可测试的软件。
2. **规划文件结构** — 先列出要新建或修改的文件及各自职责，按职责而非技术层拆分，并沿用现有代码库的模式。
3. **编写任务** — 按固定表头和任务模板写出每个任务的文件、接口和 TDD 步骤：写失败测试、运行、最小实现、再运行、提交。
4. **自我审查** — 对照规格检查覆盖度、步骤是否明确、类型是否一致、Review Focus 和篇幅比例，发现问题当场修正。
5. **交接执行** — 保存到 docs/superpowers/plans/ 后请用户审阅，并在 Subagent-driven 与 Native 两种执行方式中选择。

## 权限说明（据 SKILL.md 整理）

| 能力 | 是否需要 | 说明 |
|---|---|---|
| 文件写入 | 部分需要 | 只写计划文档，默认保存在 docs/superpowers/plans/，不修改代码。 |
| 命令执行 | 不需要 | 计划中会写明测试和提交命令，但本技能自身不执行。 |
| 网络外发 | 不需要 | 只依据本地规格和代码库编写，无需联网。 |

## SKILL.md 头部信息（YAML）

```yaml
---
name: writing-plans
description: Use when you have a spec or requirements for a multi-step task, before touching code
---
```

首页: https://www.myskills.tools/zh/ · URL: https://www.myskills.tools/zh/skills/writing-plans/