前言¶
产品经理和研发协作时，需求往往分散在 Markdown 文档和禅道项目里：在文档里改了一版，还要手动去禅道补字段、改描述；新建 story 又要切回浏览器填表单。若你已经在用 Cursor、Claude Code 等带 Skills 的 Agent，可以把「创建 / 编辑 / 查询禅道需求」和「需求文档回写禅道」收进同一套对话流程。下面介绍社区 Skill「禅道需求管理」的定位、能力与安装方式。
这是什么¶
「禅道需求管理」是 SkillHub 上的社区 Skill（坐标 @user_b7f4a683/zentao-story-api，版本 1.0.0，分类 business-ops，发布者 user_b7f4a683）。官方说明面向产品经理，侧重项目类型需求的创建与试用。
它通过禅道页面内置接口与 REST API 管理项目需求（story），支持创建、编辑、删除、查询，并可将需求自动关联到指定项目。此外支持需求文档与禅道需求的双向同步：文档中记录禅道需求 ID，更新文档后可一键同步到禅道。
Skill 标注 requires_api_key=true，使用前需按技能包内说明配置禅道相关访问凭证（具体字段名以安装后的 SKILL.md 为准）。
核心功能¶
以下能力均来自 SkillHub 官方页面与抓取资料，未单独列出的操作请勿假定支持。
- 需求 CRUD：对禅道 story 进行创建、编辑、删除、查询。
- 项目关联：新建或维护需求时，自动关联到指定的禅道项目。
- 文档与禅道同步：在本地或工作区编写需求文档，文档内保存禅道需求 ID；文档更新后，可触发同步，将变更推回禅道。
- 自然语言触发：对话中可使用与需求相关的表述唤起技能，官方列出的触发关键词包括：创建需求、编辑需求、删除需求、新建需求、禅道需求、zentao story、提需求、项目需求、写需求、更新需求文档、同步需求。
安装与启用¶
方式一：SkillHub CLI（推荐）¶
安装与目录约定遵循 SkillHub 安装说明。先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按官方文档执行完整安装（需联网）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别：
skillhub install user_b7f4a683/zentao-story-api --dir <你的 Agent skills 目录>
常用路径示例（以你实际使用的客户端为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
官方页面给出的坐标写法为 @user_b7f4a683/zentao-story-api；在 CLI 中安装时通常使用 user_b7f4a683/zentao-story-api 这一形式（与 skillhub install 示例一致）。安装完成后重启或重新加载 Agent，使技能生效。
方式二：让 Agent 按文档安装¶
SkillHub 页面提供的提示为：根据 https://skillhub.cn/install/skillhub.md，安装 @user_b7f4a683/zentao-story-api。适合已习惯用对话驱动安装、且 Agent 能访问该安装文档的环境。
API Key¶
标签标明需要 API Key。请在技能安装目录中阅读 SKILL.md（及同目录配置说明），完成禅道地址、令牌等配置后再执行创建或同步类操作。未在公开页面列出的配置项名称，本文不臆测。
典型用法¶
公开资料未提供逐步截图或固定项目 ID 示例，可按下述可复现思路在 Agent 中使用（具体参数由你与禅道环境决定）。
- 创建并挂到项目：在对话中说明目标禅道项目，并使用「新建需求」「创建需求」等表述，让 Agent 通过技能调用接口创建 story 并关联项目。
- 查询与修改：使用「禅道需求」「编辑需求」「更新需求」等关键词，按需求 ID 或标题查询后编辑字段。
- 文档驱动同步：在工作区维护需求文档，在文档中写入或保留禅道返回的需求 ID；修改文档后使用「更新需求文档」「同步需求」等表述，将文档内容同步回禅道。
以上步骤依赖你已正确配置 API Key 与禅道项目权限；项目类型需求的适用范围以官方简介「创建项目类型需求试用」为准。
适用场景与注意¶
适合谁
- 使用禅道做项目需求管理、且希望在 IDE / Agent 里用自然语言操作 story 的产品与研发角色。
- 习惯用 Markdown 写需求说明，又希望与禅道保持 ID 级关联、减少手工复制粘贴的人。
限制与注意
- 社区来源（
source: community），行为与禅道版本、部署方式、REST 权限策略相关，升级禅道或改 API 策略后应重新验证。 - 简介明确为产品经理场景与「项目类型需求」试用取向，是否覆盖你组织内的全部需求类型，需在真实项目中验证。
- SkillHub 页面统计（截至资料抓取）：评分 100000，下载 1469，安装 31；与第三方转载数据可能不一致，以 SkillHub 为准。
- 涉及删除需求等破坏性操作时，建议在禅道侧确认权限与回收策略，避免误删生产数据。
结尾¶
「禅道需求管理」把禅道 story 的增删改查、项目关联以及需求文档双向同步，收敛成可在 Agent 对话中触发的 Skill，适合已使用禅道且配置了 API 访问的团队。安装与优先源说明见 SkillHub 安装文档；技能详情与安装提示见 SkillHub 技能页，API 入口为 https://api.skillhub.cn/user_b7f4a683/zentao-story-api。
