前言¶
拿到一个多步骤任务的需求规格，直接开始改代码，是常见的返工来源。需求里一句话带过的目标，到实现时可能横跨多个文件、多个模块；不先对齐范围和顺序，写到一半才发现漏了前提，就要回头重做。
writing-plans 针对的就是这个阶段：在动手写代码之前，先依据已有的需求规格或要求，产出一份结构化的执行计划，把步骤、依赖、边界讲清楚，再进入实现。
这是什么¶
writing-plans 是一个面向开发流程的 Skill，坐标 @org-02qudk26/writing-plans-zh，由企业开发者智雨科技发布和维护，当前版本 1.0.0，归类在 dev-programming 下。
它解决的问题很具体：当需求规格已经到手、但代码尚未开始接触时，把”接下来要做什么”梳理成一份有顺序、有范围的计划，避免实现阶段边写边猜。
该 Skill 基于通用 SKILL.md 格式，标签显示 requires_api_key=false，即使用时不需要额外配置 API Key。
核心功能¶
writing-plans 的定位是”写代码之前的计划阶段”，而不是代码生成或调试工具。它的能力边界可以从官方简介和元数据中确认：
- 触发时机固定在”已拿到多步骤任务的需求规格或要求，但尚未接触代码”这一节点。
- 输入是需求规格或要求，输出是一份执行计划，而非可运行的代码。
- 面向多步骤任务，这意味着单步操作类请求（如查一个值）不在它的适用范围内。
- 不需要 API Key，配置负担低。
需要注意的是，官方资料里没有列出该 Skill 内部的具体步骤清单或提示词模板，因此下文不展开其内部实现细节，只描述它在流程中的位置。
安装与启用¶
writing-plans 通过 SkillHub 平台分发，坐标为 @org-02qudk26/writing-plans-zh，官方地址为：
https://api.skillhub.cn/org-02qudk26/writing-plans-zh
SkillHub 页面地址为：
https://www.skillhub.cn/skills/org-02qudk26/writing-plans-zh
关于具体的安装命令、目录结构和配置字段，本次抓取的官方页面均无法访问，资料中也未给出可核对的安装指令。因此这里不做臆测，建议你从上述官方地址进入后，按页面指引确认当前版本的安装方式。
该 Skill 基于通用 SKILL.md 格式，理论上可被支持该格式的 Agent 宿主加载；至于 Cursor、Codex CLI、Claude Code 各自是否需要额外步骤，资料未提供可核对的差异说明，此处不展开。
典型用法¶
官方资料给出的触发条件是：”在接触代码之前，当你已拿到某项多步骤任务的需求规格或要求时使用。”据此可以还原一个可复现的使用场景：
- 你手上已经有一份需求文档或任务说明，例如”给现有导出模块加上 CSV 分页导出，并补一份使用说明”。
- 此时尚未打开代码库改动任何文件。
- 触发 writing-plans，让它基于这份需求产出执行计划，包括需要改动的范围、步骤先后顺序、可能涉及的模块。
- 审阅计划，确认范围和顺序符合预期。
- 计划确认后，再进入实际的代码实现阶段。
这里的边界要说清楚：writing-plans 产出的是计划，不是代码本身。第 5 步的实现需要由你或另一个编码类 Skill 来完成，两者是先后衔接的关系，不是替代关系。
适用场景与注意¶
适合使用 writing-plans 的情况：
- 需求规格已经明确，但任务跨越多个步骤、多个模块，需要先理清执行顺序。
- 你希望在动手前有一份可审阅的范围说明，降低返工成本。
- 任务规模较大，值得先用一份计划对齐预期，而不是边写边定方向。
需要注意的限制：
- 它不替代需求澄清。如果需求本身模糊，产出的计划也会建立在不牢靠的前提上，建议先把需求问清楚。
- 它不产出代码。计划确认后仍需单独的实现环节。
- 它针对的是多步骤任务，单步、轻量的操作类请求不必经过这一步。
- 官方页面在本次核实时无法访问，安装与配置的具体细节请以官方地址页面为准。
结尾¶
writing-plans 的价值在于把”写代码”之前那个容易被跳过的规划环节标准化：拿到需求后，先产出一份有顺序、有范围的计划，再进入实现。它由智雨科技发布，版本 1.0.0，归类 dev-programming，不需要 API Key。
官方地址：
https://api.skillhub.cn/org-02qudk26/writing-plans-zh
