SuperAPI AI 工具集

cx-plan

编程与开发

查看项目

更新于 10-16 00:03

技能介绍

用途:把需求或设计转成可执行的任务图。触发词包括规划任务、制定计划、plan、拆分任务。

主要能力:读取设计文档(小功能读需求.md),生成任务 DAG,创建任务-1.md、任务-2.md 等子任务文件,并将契约下沉到任务中。跨层任务(前端+后端、后端+数据库等)必须先生成共享契约文件,位置为开发文档/CX工作流/功能/{功能标题}/契约.md,包含 API 契约、数据模型契约、状态/枚举契约。契约来源优先级:后端已有路由/Controller 读代码提取、Design 文档定义、都没有则新定义。禁止前后端任务各自猜测 API 路径。

使用方式:/cx:cx-plan {功能名} 或 /cx:cx-plan。所有文件读写必须使用绝对路径,禁止 ../ 相对路径,先用 git rev-parse --show-toplevel 获取绝对路径。执行前需做 Worktree 检测,若返回 on_main=true,提示先运行 /cx:cx-prd 创建 worktree 或手动进入已有 worktree,不继续规划。

任务文档保留可见中文标题、稳定 slug、目标文件范围、引用的契约条目和验收标准。feature 级状态.json 记录 feature、slug、status、tasks、worktree、docs 等。规划完成后默认建议下一步 /cx:cx-exec。

限制:默认轻量,普通功能直接拆任务;仅当 PRD 明显引入新技术时才进入技术识别和 skill 准备支线。Claude Code 侧规划属于 runner cc 的 adapter 行为;共享 core 被 codex 持有时先建议 handoff。允许在用户明确确认进入规划阶段后由工作流自动衔接。