Skill 多语言阅读指南
writing-plans用途、用法与原始来源
在编写代码之前，如果您已经有了多步骤任务的规范或要求，请使用此方法。
原文采集时间:
- 来源仓库
- obra/superpowers
- SKILL.md
skills/writing-plans/SKILL.md- 仓库 Star
- 309,479
- 仓库最近更新
- 2026/10/30
- 能力分类
- Agent 工作流
- 最近采集时间
许可：MIT
流程片段用于帮助阅读上游说明。本页没有执行第三方 Skill，不属于实测评测。
下面的用途和操作片段来自上游文档，由本站整理并翻译，和另行标注的 Codez 编辑分析分开展示。
这个 Skill 能做什么
在编写代码之前，如果您已经有了多步骤任务的规范或要求，请使用此方法。
如何使用：上游操作流程
概述
为一位从未见过此代码库或规范的工程师编写实现计划。假设他们在了解确切的接口和测试用例后，会使用项目语言编写符合规范的代码，并且在计划中留有空白处，他们会做出合理的选择。他们不能知道的是你的决定：哪些文件、哪些名称和签名、规范中的哪些值、哪些测试用例来验证每个任务。将这些内容记录下来。将整个计划拆分成易于执行的小任务。遵循 DRY（Don't Repeat Yourself，不要重复自己）原则。遵循 YAGNI（You Aign I Need It，你不需要它）原则。遵循 TDD（测试驱动开发）原则。频繁提交。在开始时声明：“我正在使用编写计划的技能来创建实现计划。” 背景：如果在一个隔离的工作树中工作，则应该已经通过以下方式创建：superpowers:using-git-worktrees执行时的技巧。保存计划至：docs/superpowers/plans/YYYY-MM-DD-.md
步骤包含哪些内容
当实现者能够根据该步骤编写出一个合理的结果时，该步骤即完成。这就是全部要求：明确无误，而非完整无缺。每种步骤都包含使其明确无误的要素，仅此而已：测试步骤：测试名称及其断言（以代码形式），断言中包含规范中规定的确切值。代码步骤：确切的代码签名（名称、参数、返回类型）、代码所在的文件以及规范中规定的具体值。实现者编写代码主体。代码主体仅用于代码签名和测试无法确定的算法，或规范中规定的精确复制。验证步骤：要运行的命令以及表明验证通过的输出。
原文片段 · L140 ↗环境与依赖
本次未从该文件选出独立的环境要求片段，不代表无需依赖。请继续核对仓库的安装说明和引用文件。
限制与结果检查
本次未从该文件选出独立的限制片段，不代表适用于所有输入或环境。请阅读完整原文，并自行验证实际结果。
开始使用前
- 先核对支持的 Agent 宿主和仓库安装说明。保留完整 Skill 目录及其引用的脚本、资源和文档，只复制 SKILL.md 可能漏掉依赖。
- 向 Agent 提供实际输入、期望输出和验收标准。调用方式与可用工具取决于宿主环境，本站不假定存在通用的安装命令。
- 先在临时项目或输入副本上试用。涉及修改文件、远程服务或计费资源的操作，应逐项核对后再授权。
- 按照原文检查项和自己的需求验证输出。成功触发或仓库 Star 较高，都不能证明结果正确。
继续阅读原始文档
相关 Skill
翻译与介绍范围
本页从固定版本的上游 SKILL.md 整理用途与操作片段，译文使用辅助翻译。它不是完整手册，也不代表经过兼容性实测；使用前请核对原文及其引用文件。
介绍依据下方列出的固定版本；当前仓库动态和目录采集时间单独展示。
- 固定版本来源
- 阅读原文 ↗
- 原文采集时间
- 来源提交版本
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- 原文 SHA-256
a6c67c1900064347c2a329990dd3c555657c51c3ec53b259a08aa01a2c26139a