메뉴
执行开发计划，按照 tasks.md 逐个完成任务。自动检查 spec.md 是否存在，不存在则先执行 /wf-plan。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | wf-do |
| description | 执行开发计划，按照 tasks.md 逐个完成任务。自动检查 spec.md 是否存在，不存在则先执行 /wf-plan。 |
| metadata | {"version":"1.0.0","execution_location":"documentation_repository"} |
⚠️ 重要约束：本技能在文档仓库执行，但只能操作代码仓库的代码文件
按照 spec.md 和 tasks.md 逐个执行开发任务。
# 执行当前 active 的计划
/wf-do
# 执行指定的计划
/wf-do docs/changes/active/2026-04-24-add-registration
# 执行并跳过已完成的任务
/wf-do --continue
读取 .wikiflow/config.json：
→ 获取 paths.code（代码仓库路径，如 ../wikiflow）
→ 获取 language、project 等配置
**检查当前仓库类型**：
检查当前目录特征：
IF 存在 .wikiflow/config.json AND docs/wiki/ 目录:
→ 当前是文档仓库
→ ✅ 继续执行
ELSE:
→ ⚠️ 警告：当前目录不是文档仓库
→ 提示用户："wf-do 需要在文档仓库执行（读取 spec.md、tasks.md）
当前目录：{当前目录}
文档仓库特征：存在 .wikiflow/config.json 和 docs/wiki/
请切换到文档仓库后重试"
→ 退出执行
**操作约束检查**（AI 执行时必须遵守）：
✅ 允许的操作：
→ 读取文档仓库：spec.md、tasks.md、decisions.md、wiki/
→ 修改文档仓库：tasks.md（标记任务完成）
→ 修改代码仓库：通过 paths.code 路径操作代码文件（../wikiflow/src/*）
❌ 禁止的操作：
→ 在文档仓库修改代码文件（文档仓库不应该有代码文件）
→ 在代码仓库修改文档文件（spec.md、tasks.md 必须在文档仓库）
→ Git 操作代码仓库（由用户在 /wf-finish 时处理）
读取文档仓库中的 spec.md：
→ 了解目标、方案、影响范围
读取文档仓库中的 tasks.md：
→ 获取任务清单
→ 统计已完成/未完成任务
FOR 每个未完成的任务:
1. 读取任务描述
2. 通过 paths.code 定位代码仓库（如 ../wikiflow/）
3. 查看代码仓库中的相关代码（根据 spec.md 的影响范围）
4. **只在代码仓库路径下**执行代码修改
5. 在文档仓库中标记任务为已完成（更新 tasks.md）
IF 任务执行失败:
→ 提示错误信息
→ 询问是否继续下一个任务
→ 如果不继续，退出
IF 开发中发现需要修改 specs:
→ 提示用户执行 /wf-fix 更新 specs
→ 或暂停，等待用户确认
📊 开发进度
计划：添加注册功能
总任务：8
已完成：3 / 8（37.5%）
✅ [后端] 设计 users 表结构
✅ [后端] 实现注册 API
✅ [前端] 创建注册页面
⬜ [后端] 实现登录 API 更新
⬜ [后端] 编写单元测试
⬜ [前端] 更新登录页面
⬜ [前端] 移除首次改密弹窗
⬜ [前端] 添加表单验证
所有任务完成时：
✅ 所有任务已完成
下一步：
→ /wf-fix 修正问题（如果有）
→ /wf-finish 编译到 Wiki
开发过程中可能发现问题或需要改进：
场景：执行到"创建注册页面"时，发现应该"注册后自动登录"
选项：
1. 先完成当前任务，然后 /wf-fix
2. 暂停当前任务，立即 /wf-fix
3. 忽略，继续按计划执行
推荐：先完成当前任务，然后 /wf-fix
执行位置：
操作边界：
执行规范：
架构参考：
编译 Wiki，将 active 变更同步到知识库。自动处理历史版本、废弃功能、决策日志，并执行 lint 检查。完成后清理 active 目录。
修正开发过程中的问题和需求改进。AI 自动判断是 bug 还是需求改进，更新 spec.md 和 tasks.md，生成 decisions.md。仅在 /wf-do 之后使用。
初始化 WikiFlow 项目。对话确认配置，创建目录结构，生成 config.json。是使用 WikiFlow 的第一步。
检查 Wiki 文档质量。查找错误、矛盾点、孤岛文件、废弃残留等。优先检查 current/，必要时扩展到 history/。
制定开发计划，生成 spec.md 和 tasks.md。自动匹配相关 Wiki，强制文档先行。适用于新功能开发、bug 修复、需求改进。不可跳过。
查询 Wiki 知识库，了解当前系统实现和历史决策。在制定计划前了解背景，或随时查询项目文档。