前言¶
在 Cursor、Claude Code 等 Agent 里处理跨多轮、多文件的任务时，常见问题是范围在对话里逐渐漂移：上一轮说好的验收标准下一轮被忘掉，中间步骤也没有可对照的落盘记录。靠纯聊天记进度，重启会话或换模型后很难续上。
下面介绍 SkillHub 上的社区 Skill @user_fccf428b/planning（展示名：复杂任务范围、步骤与验收计划制定｜简诗 AI）。它面向「先定范围与步骤、再执行、并能跟踪进度」这类需求，通过创建并维护持久的 Markdown 规划文件，把任务结构化下来，供 Agent 按规划执行。
这是什么¶
一句话定位：为结构化任务执行创建并管理持久的 Markdown 规划文件。
- 坐标：
@user_fccf428b/planning - 版本：1.0.0
- 分类：business-ops（SkillHub）
- 发布者：user_fccf428b（Skill 名称中带「简诗 AI」）
- 来源：community
- 是否需要 API Key：
requires_api_key=false（SkillHub 标签）
官方简介（英文，SkillHub 原文）说明适用时机：当用户要求「create a plan」「track progress」「start a research project」，或出现与规划、进度跟踪相关的业务场景时，可启用该 Skill。
SkillHub 页面：https://www.skillhub.cn/skills/user_fccf428b/planning
安装说明入口：https://skillhub.cn/install/skillhub.md
核心功能¶
依据 SkillHub 已公开描述，可核实的能力如下：
- 创建规划：为当前任务生成并维护 Markdown 形式的规划内容（范围、步骤、验收等由 Skill 内规则驱动，具体字段以安装后的
SKILL.md为准）。 - 持久化：规划写在文件里，而不是只留在对话上下文中，便于长任务、多轮执行时对照。
- 进度跟踪：与「track progress」类请求配合，在既有规划文件上更新或核对执行状态。
- 研究类项目入口：用户提出「start a research project」或同类需求时，可用同一套规划文件机制组织调研与交付步骤。
未在公开页面单独列出的能力（例如具体文件名、目录结构、子命令）本文不展开，避免与真实 Skill 内容不一致。
安装与启用¶
SkillHub 推荐方式：让 Agent 按 SkillHub 安装文档 安装本 Skill。页面对应提示为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_fccf428b/planning`。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可用官方脚本（完整安装含默认 Skill；仅需 CLI 时加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录；默认装到 ./skills/ 可能不会被识别。
skillhub install user_fccf428b/planning --dir <你的 skills 目录>
常用路径（摘自 SkillHub 安装文档，按你实际使用的客户端选择）：
| 客户端 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或项目下 .windsurf/skills/ |
安装后若客户端要求重启或重新加载 Skills，按其产品说明操作。
典型用法¶
公开资料未附带完整 SKILL 正文，下面是可以直接复现的触发方式与预期行为（与简介一致）：
-
新建计划
在对话中明确说要「制定计划」「create a plan」，并描述任务目标。Agent 在启用该 Skill 后，应倾向于生成或更新 Markdown 规划文件，而不是只在回复里列一遍清单。 -
跟踪进度
执行过程中说「跟踪进度」「track progress」，或要求对照计划检查完成情况。预期是在已有规划文件上反映当前状态（具体写法由 Skill 规则定义）。 -
启动研究项目
使用「start a research project」或中文等价表述（例如「开始一个调研项目并做计划」），用同一套持久化规划机制组织步骤与验收。
若需核对规划模板、文件命名或更新流程，请在安装后阅读技能包内的 SKILL.md。
适用场景与注意¶
适合谁
- 需要把「范围、步骤、验收」写清楚再让 Agent 执行的一线开发、产品或运营同学。
- 任务会跨多轮对话、多文件改动，希望有一份可打开的 Markdown 作为单一事实来源。
- 分类为 business-ops，偏业务流程与执行管理，而非单一代码片段生成。
注意
- 本 Skill 不需要 API Key；仍须正确安装到 Agent 的 skills 目录。
- 社区来源（community），版本当前为 1.0.0；升级可用
skillhub的 install/update 流程，并继续指定--dir。 - SkillHub 统计（抓取时点）：评分 100000，下载 1378；以 SkillHub 页面实时数据为准。
- 规划质量取决于你对目标、边界和验收标准的描述；Skill 负责结构化与持久化，不能替代你对业务范围的判断。
结尾¶
@user_fccf428b/planning 解决的是复杂任务在 Agent 对话里「计划易丢、进度难对齐」的问题：用持久 Markdown 规划文件承载范围、步骤与验收，并在 create plan、track progress、research project 等场景下由 Agent 按 Skill 规则维护。
安装与优先源配置：https://skillhub.cn/install/skillhub.md
Skill 详情页：https://www.skillhub.cn/skills/user_fccf428b/planning
