跳到主要内容

Writing Plans 技能

把已认可的设计转成可审阅的工程任务,明确接口与验证方式。

社区 · Jesse Vincent / Prime Radiant
作者Jesse Vincent / Prime Radiant
许可证MIT
来源obra/superpowers · GitHub 上的 SKILL.md
项目官网primeradiant.com/superpowers
适用于Claude Code · Codex、Gemini CLI、Cursor、Copilot
读取源文件日期

writing-plans 技能将已认可的规格转成实现计划,供没有历史上下文的工程师执行。计划记录准确路径、接口、约束及验证命令。

计划是交接文档,并不代表实现完成。任务按完整改动分组,明确输入和输出,方便不同开发者协作。

摘自该技能的 SKILL.md: writing-plans

这是 Jesse Vincent / Prime Radiant 发布的社区技能,未经我们或 Anthropic 审核。技能可以让智能体运行代码、读取文件或访问网络。安装前请阅读它的 SKILL.md 和文件夹中的每个脚本,留意任何与其声称用途不符的内容。

功能

  1. 阅读已认可的规格并检查相关代码。
  2. 定义全局约束、接口和可审阅的任务。
  3. 自行检查计划,并商定执行方式。

产出内容

  • 在 docs/superpowers/plans/YYYY-MM-DD-<feature>.md 保存带任务步骤和验证的计划。

适用场景

  • 把多步骤改动交给没有阅读本次对话的工程师。

不适用的场景

  • 需求尚未明确时,应先用 brainstorming。

所需条件

  • 已认可的规格、能操作文件的编码代理及项目访问权限。
  • 执行、测试及提交仍需项目自身的工具与权限。

技能包含的文件

文件或文件夹用途
SKILL.md计划结构、任务粒度与交接要求。

2026-11-19 在仓库中查到的许可证:MIT。

示例提示词

安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。

  • 把这份已认可设计变成计划,明确接口和验证命令。
  • 检查这些任务是否为完整改动,而不是机械地每个文件一个任务。
  • 为全新工程师规划此迁移,说明全局约束。

如何安装 writing-plans

安装与权限

完整 Superpowers 插件保留 brainstorming 与执行技能的链接。规划文件夹本身只含 SKILL.md。

来源计划含测试先行步骤与提交要求。执行须适应仓库规则;创建计划不会运行这些步骤。

技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:

Claude Code:从插件市场安装

  1. 在终端中用 claude 启动 Claude Code。
  2. 该插件位于 Anthropic 官方插件市场,Claude Code 首次启动时会自动为你添加。
  3. 安装插件。Claude Code 会先显示插件详情:确认它会添加哪些内容(技能、Hooks、MCP 服务器),然后选择安装给你自己、给该仓库的所有人,还是仅在该仓库中给你自己使用。
    /plugin install superpowers@claude-plugins-official
  4. 输入 / 查找 /superpowers:writing-plans,或直接提出任务。

也可以不进入会话,直接在 shell 中运行:

claude plugin install superpowers@claude-plugins-official

Claude Code:把文件夹复制到技能文件夹

把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。

git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p ~/.claude/skills
cp -R superpowers/skills/writing-plans ~/.claude/skills/

Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /writing-plans,或直接描述任务。

在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。

Codex、Gemini CLI、Cursor 和 GitHub Copilot

这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:

git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p .agents/skills
cp -R superpowers/skills/writing-plans .agents/skills/
智能体项目文件夹用户文件夹说明
OpenAI Codex
.agents/skills/
~/.agents/skills/
输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。
只安装你信任的技能. Anthropic 的建议是只使用可信来源的技能,其他技能在使用前要读完每个文件:技能可能以其描述中未提及的方式,指示智能体运行命令、读取文件或发送数据。

这些步骤的来源

已于 2026-11-14 对照各厂商的文档核实:

跨上下文仍可用的计划

全局约束跨任务适用;任务接口注明每步消费和产出的内容,减少交接中的隐含假设。

执行前检查计划。再详细的命令,在实际运行并核对结果前也只是提议。

关于 writing-plans 的常见问题

它会执行计划吗?

不会。它编写并检查计划,再交给已商定的执行方法。

任务应包含哪些背景?

准确路径、接口、相关约束、实现步骤和具体验证命令。

每个文件都应单独成任务吗?

不应。任务应是完整且可审阅的改动,仅按文件边界拆分不够。

需要付费服务吗?

技能未指定额外服务,但代理订阅或 API 使用仍可能收费。

更多 AI 技能

相关技能

技能分类