SuperAPI AI 工具集

cawplan-plan-create

通用与其它

查看项目

更新于 10-15 20:11

技能介绍

用途:该技能用于在 CawPlan 中创建版本计划。入口分两类:用户给出明确版本名(可选明确工单列表)时走直接创建流程;用户粘贴 OKR/阶段目标并要求据此生成计划时走 OKR 驱动流程。

主要能力:解析产品名到 product_id、创建版本、在版本下创建工单、从待办(backlog)中提取并去重工作项、将已有待办工单移动到新版本、创建前生成预览并等待确认。工单字段约定:description 放简短标题/摘要,remarks 放详细正文(支持 HTML),长正文不得放入 description。

必要用法:先执行 cawplan skill check。解析产品用 cawplan products list --search "<product name>",仅在名称精确匹配、唯一短名/前缀匹配或用户明确确认候选后才继续。创建版本用 cawplan versions create <product_id> --name <X.Y.Z> --description "<goals>"。创建工单用 cawplan tickets create-version <product_id> <version_id> --description "<ticket title/summary>" --remarks "<html body>" --type FEATURE --priority MEDIUM。OKR 流程需先分页拉取待办:cawplan backlog list <product_id> --page_size 100,按 total 翻页,保留 unique_id(非 display_id)及类型/优先级。移动待办工单用 cawplan tickets update <product_id> <product_id> <backlog_ticket_unique_id> --target_version_id <new_version_id>。需要 --major_id 时先用 cawplan versions list <product_id> 解析。分配人可用 cawplan users query --email <email>。

适用场景:需要按版本组织产品工作项、把 OKR 转成工单、或将待办工单纳入新版本时。

限制:CawPlan 工单结构中没有工作量估算或故事点字段,任何估算都只是粗略猜测,必须明确标注为未验证。版本名必须为 X.Y.Z 格式且不得自动生成或自增;产品不明确时须列出候选询问,不得猜测或创建。工单类型默认 FEATURE、优先级默认 MEDIUM。未明确描述或 OKR 未实际陈述的工作项不得创建。创建/更新前必须获得明确确认。部分重叠的待办项应作为新工单并在 remarks 中标注可能相关,而非静默合并。更多细节见 references/CAWPLAN_OPEN_API.md。