SuperAPI AI 工具集

todo-create

办公与效率

查看项目

更新于 10-16 05:42

技能介绍

用途:在文件式待办系统中创建持久化工作项、管理待办生命周期、跨会话跟踪发现。每项待办为一个带 YAML frontmatter 的 Markdown 文件。

存放路径:规范路径(写入用).context/compound-engineering/todos/;旧路径(只读)todos/。读取时需同时检查两者,新待办只写入规范路径。该目录具有多会话生命周期,不应作为临时文件清理。

命名规则:{issue_id}-{status}-{priority}-{description}.md。issue_id 为顺序号(001、002…),不复用;status 为 pending|ready|complete;priority 为 p1(关键)|p2(重要)|p3(可选);description 用 kebab-case 简短描述。示例:002-ready-p1-fix-n-plus-1.md。

结构:YAML frontmatter 含 status、priority、issue_id、tags、dependencies(被哪些 issue_id 阻塞)。必需小节:Problem Statement、Findings、Proposed Solutions、Recommended Action(分类时填写)、Acceptance Criteria、Work Log;可选:Technical Details、Resources、Notes。

创建流程:mkdir -p .context/compound-engineering/todos/;在两路径搜索 [0-9]-.md,取最大编号加一并补零至 3 位;按模板写入 {NEXT_ID}-pending-{priority}-{description}.md;填写各必需小节与初始 Work Log;状态设为 pending(待分类)或 ready(已预批)。当工作超过约 15 分钟、存在依赖、需要规划或需排优先级时创建待办;若修复琐碎、明确且自包含则直接处理。

分类待处理项:glob 两路径下 -pending-.md,审阅 Problem Statement、Findings、Proposed Solutions;批准则将文件名与 frontmatter 中 pending 改为 ready 并填 Recommended Action;延后则保持 pending。交互式审批可加载 todo-triage 技能。

依赖管理:dependencies 列出被阻塞的 issue_id 或留空。检查阻塞项时在两路径搜索 {dep_id}-complete-*.md,无匹配即表示阻塞未完成。

完成待办:验证全部验收标准;更新 Work Log;将 ready 改为 complete(文件名与 frontmatter);搜索含 dependencies:.*"{issue_id}" 的文件以发现被解除阻塞的工作。

工作流集成:代码评审 /ce:review -> Findings -> /todo-triage -> Todos;自主评审 /ce:review mode:autofix -> 残余 todo -> /todo-resolve;代码 TODO /todo-resolve -> 修复与复杂待办;规划 头脑风暴 -> 创建待办 -> 工作 -> 完成。

关键区别:本技能管理以 Markdown 文件持久化的跨会话工作项;临时会话内步骤跟踪应使用平台任务工具(如 Claude Code 的 TaskCreate/TaskUpdate、Codex 的 update_plan)。

限制:资料未提供收费、平台支持范围及具体版本要求信息。