| name | flowcode-todo |
| description | 从 wiki 索引生成 vibe coding 任务计划，并在需要时先调用 flowcode_wiki 生成或更新 wiki。如果涉及页面/UI 设计，在调用 flowcode_wiki 前先调用 flowcode_ui 定义页面设计规范。Use when Codex 需要根据现有 wiki 生成 todos，或用户给的是 Markdown 文档而目标是"先整理成 wiki 再生成任务计划"的综合流程；适用于要求任务由简单到复杂、每个任务链接到对应 wiki 小文档、且输入输出路径不能写死的场景。 |
Docs Wiki Todo Planner
使用目标
基于 wiki 总目录生成可执行的 vibe coding 任务计划；如果输入还是原始 Markdown 文档，则先调用 flowcode_wiki 生成或更新 wiki，再继续生成任务计划。如果输入涉及页面/UI 设计，在调用 flowcode_wiki 之前先调用 flowcode_ui 生成页面设计规范文档，确保后续 wiki 和任务计划中包含明确的设计参考。
核心原则：自动运行，自主找方案，实在不能运行就停止。遇到问题时先自行分析并尝试解决，不等待用户介入；多个方案可选时，选择最优方案直接执行；只有确认无法继续时才停止任务并说明原因。
支持四种模式：
- 仅生成 wiki：直接调用
flowcode_wiki，本 Skill 不重复实现 wiki 生成细则。
- 生成 todo list：从 wiki 索引生成任务计划文档。
- 综合流程：先调用
flowcode_wiki 生成 wiki，再基于刚生成的 wiki 生成任务计划。
- 含 UI 设计的综合流程：先调用
flowcode_ui 定义页面设计规范，再调用 flowcode_wiki 生成 wiki，最后生成任务计划。
必须遵守：
- 输出使用中文，除非用户明确要求其他语言。
- 不修改源文档原文。
- 不改动代码、配置和无关目录。
- 不创建临时文件或额外总结文档。
- 只创建或更新用户要求的目标文件/目录。
- 所有生成的链接必须指向真实存在的目标文件；写入后要校验。
路径策略
不要把目录写死。把路径视为可配置参数：
sourceDocsDir 源 Markdown 文档目录
wikiDir wiki 输出目录
wikiIndex wiki 总目录文件
todoOutput 任务计划输出文件
推断顺序：
- 优先使用用户明确给出的路径。
- 如果用户只给出
docs/wiki/README.md，则 wikiDir 是其父目录，wikiIndex 是该文件。
- 如果用户只说"根据 wiki 生成 todo"，优先查找当前项目中已有的 wiki 索引，例如
<wikiDir>/README.md；不要假设只有根目录 docs/wiki/README.md。
- 如果用户只说"根据 docs 生成 wiki"，优先查找当前项目中明显的 Markdown 文档目录，例如
docs/；如果存在多个候选且无法判断，按以下决策顺序处理：分析各候选目录的上下文与当前任务相关性，推断最优候选并执行；无法推断则停止任务并说明原因。
- 如果用户要求输出到
todos.md，按要求写入；否则将任务计划写入用户指定的 todoOutput，没有指定时才默认使用项目根目录的 todos.md。
在汇报中说明实际采用的路径。
模式路由
先判断当前输入属于哪一种：
- 用户只要求生成或更新 wiki。
- 直接使用
flowcode_wiki。
- 不要在本 Skill 内重复描述或实现 wiki 拆分、导航、关系图谱和校验细节。
- 用户给了现成
wikiIndex 或明确说"根据 wiki 生成 todo"。
- 用户给的是原始 Markdown 文档，目标是任务计划，且文档内容涉及页面设计、UI 界面、交互设计、前端页面等功能。
- 先调用
flowcode_ui 生成页面设计规范文档（UI 设计师文档）。
flowcode_ui 的输入为 sourceDocsDir，输出为独立的 UI 设计说明文档。- 再调用
flowcode_wiki 生成或更新 wiki（wiki 内容会引用 UI 设计说明文档作为设计参考）。
- 最后读取生成后的
wikiIndex，进入"生成 todo list 流程"。
- 用户给的是原始 Markdown 文档，目标是任务计划，但不涉及页面/UI 设计。
- 先使用
flowcode_wiki 生成或更新 wiki。
- 再读取生成后的
wikiIndex，进入"生成 todo list 流程"。
判断是否涉及页面/UI 设计
在模式路由步骤 3 中，需要判断源文档是否涉及页面设计。满足以下任一条件即视为涉及 UI 设计：
- 文档中描述了具体的页面、界面、仪表盘、表单、列表等前端视图。
- 文档中包含交互说明、页面布局、组件结构、设计稿引用等内容。
- 文档主题是 Web 应用、移动端页面、管理后台等前端项目。
- 用户明确提到"设计页面""UI""前端界面"等关键词。
如果以上条件均无法明确判断，按以下决策顺序处理：
- 先分析源文档内容，尝试根据上下文推断是否涉及 UI 设计。
- 如果能推断出最优方案（涉及 UI → 走步骤 3；不涉及 → 走步骤 4），按最优方案执行。
- 以上均无法判断则停止任务，说明无法确定的原因。
如果涉及 UI 设计：
- 调用
flowcode_ui 时，使用与 flowcode_wiki 一致的 sourceDocsDir 作为输入。
flowcode_ui 的输出路径由用户指定或自动推断，默认放在 wikiDir 同级或 wikiDir 内的 ui-design/ 目录下。flowcode_ui 生成的 UI 设计说明文档会被后续 flowcode_wiki 作为源文档纳入 wiki 索引，确保 wiki 中包含设计参考链接。- 生成的 todo list 中，涉及页面的任务应引用对应的 UI 设计说明文档作为参考。
生成 todo list 流程
当用户要求"根据 docs/wiki/README.md 生成 vibe coding 任务计划，要求先简单后复杂；每个任务指向对应的 wiki 小文档；任务计划放到 todos.md 文档"时，执行以下流程。
- 读取
wikiIndex。
- 提取快速入口、推荐检索路径、关系图谱、细分文档树。
- 以索引中真实存在的链接作为任务引用来源。
- 必要时读取相关 wiki 小文档。
- 优先读取任务所需的小文档，而不是一次性加载整个 wiki。
- 任务标题和验收标准必须来自 wiki 内容或其明确关系，不要编造产品能力。
- 按"先简单后复杂"组织任务。
- L1：项目启动、基础契约、健康检查、最小数据结构。
- L2：核心 CRUD 和页面/接口入口。
- L3：工作流、状态机、日志、可追踪性。
- L4：AI 执行、分析、拆解、沙箱或外部工具集成。
- L5：Git、PR、自动化闭环。
- L6：插件、扩展点、Skills、测试用例等扩展能力。
- L7：监控、部署、多租户、测试策略、生产化能力。
- 如果 wiki 主题不同，按实际主题调整层级；保持由低依赖到高依赖、由单模块到跨模块闭环。
- 每个任务必须包含：
- 任务编号，例如
T01、T02。
- 目标：一句话说明要做什么。
- 参考 wiki 小文档：至少一个真实存在的 wiki 链接。
- 验收：可检查的完成标准。
- 写入
todoOutput。
- 如果目标文件已存在，先读取并判断是覆盖、更新还是合并；用户已明确要求"生成/放到"该文件时，可以更新该文件，但不要改无关内容。
- 不额外创建 changelog、summary、临时检查报告。
推荐结构：
# Vibe Coding 任务计划
来源：`<wikiIndex>`。
## 执行约定
- 每个任务先读参考 wiki 小文档。
- 每个任务只实现当前目标。
- 每个任务完成后按验收标准检查。
## L1 入门：...
- [ ] T01 ...
- 目标：...
- 参考 wiki 小文档：
- [...](...)
- 验收：...
校验要求
生成或更新 todo list 后检查：
- 任务层级是从简单到复杂。
- 每个任务都有目标、参考 wiki 小文档和验收标准。
- 每个任务至少有一个 wiki 链接。
- todo list 中所有 wiki 链接都能指向真实文件。
- 任务编号连续，不重复。
如果本次流程包含 wiki 生成或更新，则 wiki 部分的结构与链接校验直接遵循 flowcode_wiki 的规则，不要在这里维护第二份校验清单。
如果用户要求"循环检查 N 次"，用同一套确定性检查重复 N 次，并汇报每轮结果，例如：
ROUND=1 LEVELS=... TASKS=... LINKS=... MISSING=...
ROUND=2 LEVELS=... TASKS=... LINKS=... MISSING=...
ROUND=3 LEVELS=... TASKS=... LINKS=... MISSING=...
汇报格式
完成后简短说明：
- 使用的源文档目录、wiki 目录、wiki 索引和 todo 输出文件。
- 创建或更新了哪些文件。
- 如果调用了
flowcode_wiki，说明是“直接复用 flowcode_wiki 完成 wiki 阶段”。
- 如果调用了
flowcode_ui，说明“已先通过 flowcode_ui 生成页面设计规范文档”，并给出设计文档路径。
- 校验结果，尤其是链接缺失数量。
- 如果无法完成自动校验，明确说明原因和残余风险。
