项目规划 · 卡兹克推荐 309.8k 仓库 Star
Writing Plans
把确认过的需求写成可执行计划
实施计划编写是为已有规格安排开发步骤的 Skill。它说明相关文件、接口与数据决策、测试方法和全局约束,让尚未接触项目的开发者也能理解安排。适合需求已确定、即将开始编码,或把实现工作交给其他 Agent 的阶段。
你需要准备:已确认的需求或规格、项目代码,以及需要保留的约束和行为
一桉AI 整理 · 更新 · 查看 GitHub 来源
粘贴到 Codex,它会先检查安装条件,再引导你使用。
Writing Plans 能帮你做什么?
核对代码与规格
查看现有结构和相关接口,保留已确认的需求与约束,减少计划与真实项目脱节。
写出可执行步骤
把任务拆到可操作的程度,列出需要修改的文件、重要接口和实现顺序,避免留下关键决定。
安排逐步验证
为交付行为配置相关测试或检查,记录必要依赖和最终审查重点,供执行时核对。
什么时候适合用?
下面是用法示例,可换成你的材料和目标。
准备实施支付回调
例如先梳理事件类型和重复请求规则,再安排实现、失败路径与测试,而不是直接开始改接口。
把功能交给新会话
例如让新 Agent 按计划找到文件、理解已定接口和运行检查,减少重新解释细节的成本。
怎么开始使用?
需求规格与项目现状
准备这些材料实施计划编写
已确认的需求或规格、项目代码,以及需要保留的约束和行为
实施计划整理流程
- 01
核对规格和相关代码
- 02
拆分交付任务与验证方法
- 03
整理计划和待确认项
准备什么,会得到什么?
- 准备的材料
- 已确认的需求或规格、项目代码,以及需要保留的约束和行为
- 交付的结果
- 一份包含任务顺序、文件、接口决定与检查步骤的实施计划。
- 全局约束、审查重点及尚未决定的问题清单。
使用前要知道
应使用完整 Superpowers Codex 插件及关联资源,并提供可读取的项目与规格。计划中的命令需按实际环境核对;写好计划不会自动完成开发或证明功能正确。
常见问题
和 To Spec 的作用有什么区别?
规格主要说明用户问题和应该具备的行为。实施计划进一步说明怎样在当前代码中完成,展开文件、接口和验证步骤。
拿到计划后能换执行方式吗?
可以按宿主能力和任务规模选择同一会话执行或分工执行。交接时仍需保留已确认的决策,并在实际实现后重新验证。
GitHub 与官方参考
依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。
- writing-plans · SKILL.md ↗2026-10-31 核对
- Superpowers · Codex 完整插件说明 ↗2026-10-31 核对
来源与使用条件
- 原始项目
- obra/superpowers ↗
- 作者/维护者
- obra / Superpowers
- 推荐者
- 数字生命卡兹克
- 介绍出处
- 查看推荐介绍 ↗
- Skill 名称
writing-plans- Skill 目录
skills/writing-plans- 仓库 Star
- 309,781 · 2026-10-31 核对,仅代表仓库关注度。
- 许可说明
- MIT
- 使用条件
- 按上游 Codex 方案安装完整 Superpowers 插件,保留关联 Skill、模板和资源。需要可读取的项目代码与规格;计划中的运行命令和测试方法必须依据项目现有环境核对。
- 注意事项
- 卡兹克推荐的是 Superpowers 整套开发流程,所展示的案例使用 Claude Code,不代表本单项已有 Codex 对照实测。当前 README 提供 Codex App/CLI 官方插件市场安装方案;本站仅核对来源,未运行实测。 本项交付实施计划,具体开发与执行由后续任务承接;计划不能替代实际运行后的验证结果。
查看安装与使用提示词
请帮我准备并使用 Writing Plans Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。 【来源与目标】 原始仓库:https://github.com/obra/superpowers 所选目录:skills/writing-plans 参考分支:main 原始目录 frontmatter name:writing-plans 安装后的目标调用名:writing-plans 来源页面:https://github.com/obra/superpowers/tree/main/skills/writing-plans 安装路线核对日期:2026-11-01 writing-plans:当前源 SKILL.md:https://github.com/obra/superpowers/blob/main/skills/writing-plans/SKILL.md Superpowers:当前 Codex App/CLI 插件安装:https://github.com/obra/superpowers/blob/main/README.md#codex-app Superpowers:Codex 插件清单:https://github.com/obra/superpowers/blob/main/.codex-plugin/plugin.json 【先检查环境,再安装】 先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。 下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。 这是插件安装路线。按下列官方入口安装完整插件;仅复制某个 Skill 目录不能代替插件、连接器或 MCP 配置。若当前 Codex 必须由用户在界面完成插件安装或授权,请给出准确入口和最短步骤,完成后再检查所选 Skill。 所选 Skill 的具体安装步骤: 1. 先检查 Superpowers 是否已通过 Codex 插件安装;已安装则检查来源和版本,不叠加旧手工 Skills 目录。 2. Codex App 使用侧栏 Plugins,在 Coding 中找到 Superpowers,点击 + 并完成原生安装提示。 3. Codex CLI 使用 /plugins,搜索 superpowers,然后选择 Install Plugin。当前上游将 Codex 指向官方插件市场,不再使用旧 .codex/INSTALL.md。 4. 保留整插件、using-superpowers 引导、其他被调用 Skills 与所列资源;不要把单个 SKILL.md 的下载成功当作整套流程安装完成。 5. 检查 Skill 可发现状态;未出现时再重载或新聊天,涉及插件原生配置时按宿主提示处理。 必须保留的资源: - 完整 Superpowers 插件(.codex-plugin/plugin.json、skills/ 及插件引导资源) - skills/writing-plans/(整目录) 已知依赖:按上游 Codex 方案安装完整 Superpowers 插件,保留关联 Skill、模板和资源。需要可读取的项目代码与规格;计划中的运行命令和测试方法必须依据项目现有环境核对。 原项目许可:MIT 特别条件:卡兹克推荐的是 Superpowers 整套开发流程,所展示的案例使用 Claude Code,不代表本单项已有 Codex 对照实测。当前 README 提供 Codex App/CLI 官方插件市场安装方案;本站仅核对来源,未运行实测。 本项交付实施计划,具体开发与执行由后续任务承接;计划不能替代实际运行后的验证结果。 需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。 【安装后验收】 读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。 1. 核对插件来源 obra/superpowers、当前所选 Skill 的 name 与源文件一致,并能通过 Skill 选择器明确选中。 2. 检查项目规格与文件可读,确认计划输出位置;安装检查不创建计划、不建立分支或执行实现任务。 Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。 分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。 【接着引导我使用】 请使用实际可用的 $writing-plans;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。 - 先给经过确认的规格、项目结构和验收约束,再调用 $writing-plans,拆成可执行的小步骤、准确文件路径与验证命令。 - 默认计划位置为 docs/superpowers/plans/YYYY-MM-DD-<feature>.md;用户已有目录约定优先。写出计划不等于已实施或已通过测试。 我想完成的任务: 根据我已经确认的需求或规格,为当前项目编写实施计划。先核对现有结构和相关接口,再拆成有明确交付行为的小任务,写清需要处理的文件、已确定的接口与数据约束、关键测试和完成条件。标出未确定事项与任务依赖,保存计划供后续执行,不把尚未实施的功能写成完成。 需要我提供的材料: 已确认的需求或规格、项目代码,以及需要保留的约束和行为 期望得到: 一份可交给后续开发执行的计划文档,包含任务、依赖、接口决策、验证步骤和待确认项。 先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。