禅道项目需求管理

要解决的问题

很多禅道项目需求仍靠页面手工填写，需求文档和线上需求容易脱节：文档里写了 F005，禅道里不知道对应哪个 ID；改完描述也不清楚是否已同步。这个技能把“需求文档 ↔ 禅道需求”的流程接口化，减少重复录入。

工作方式

它通过 config.json 配置 zentao_url、账号、default_project、default_product 和 requirements_doc。运行时先用 /api.php/v1/tokens 获取 token，并作为 zentaosid cookie 或 Token 请求头使用。

• 创建/编辑：创建使用页面内置接口，避免项目型需求池必须填产品字段的问题；编辑前会查询当前值，只提交修改字段。
• 删除/查询：使用 REST API DELETE /api.php/v1/stories/{storyID} 和 GET /api.php/v1/stories/{storyID}。
• 文档同步：功能标题写成 ### F001 - 功能名（#155）。有 #ID 时更新禅道需求；无 #ID 时创建并回写 ID。描述按用户故事、前置条件、功能要点等结构转成 HTML，避免写英文字段名和 UI 样式。

注意点

该技能依赖 Python 3.7+ 和 requests，且创建/编辑请求要求 multipart/form-data 并带空 files[] 字段。它只管理需求生命周期，不替代评审、排期或权限设计；文档更新默认需要用户确认后才同步。