메뉴
制定开发计划，生成 spec.md 和 tasks.md。自动匹配相关 Wiki，强制文档先行。适用于新功能开发、bug 修复、需求改进。不可跳过。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | wf-plan |
| description | 制定开发计划，生成 spec.md 和 tasks.md。自动匹配相关 Wiki，强制文档先行。适用于新功能开发、bug 修复、需求改进。不可跳过。 |
| metadata | {"version":"1.0.0","execution_location":"documentation_repository"} |
⚠️ 重要约束：本技能必须在文档仓库中执行
制定开发计划，生成 spec.md 和 tasks.md。自动匹配相关 Wiki，确保开发前了解背景。
架构依据：current/architecture.md - 文档与代码分离
# 新功能（自动搜索 Wiki + 详细询问）
/wf-plan "添加注册功能"
# bug 修复（快速模式）
/wf-plan "修复登录按钮样式"
# 带描述的计划
/wf-plan "优化登录流程" --desc "当前首次改密体验差，改为注册流程"
# 指定相关 Wiki（跳过自动匹配）
/wf-plan "修复登录按钮样式" --wiki current/authentication
读取 .wikiflow/config.json，获取路径和语言配置。
**检查当前仓库类型**：
检查当前目录特征：
IF 存在 .wikiflow/config.json AND docs/wiki/ 目录:
→ 当前是文档仓库
→ ✅ 继续执行
ELSE:
→ 当前不是文档仓库
→ ❌ 错误：wf-plan 必须在文档仓库执行
→ 报错并提示：
"❌ 操作被拒绝：wf-plan 必须在文档仓库执行
当前仓库：代码仓库（或无法识别）
尝试操作：制定开发计划（生成文档）
允许操作：代码修改、测试、构建
请切换到文档仓库后重试：
1. 查找文档仓库目录（如 ../wikiflowDev）
2. 切换到文档仓库目录
3. 再次执行 /wf-plan"
→ 退出执行
检查是否存在 active 的变更：
→ 扫描 {paths.changes}/active/
→ 如果已有同名变更，提示用户选择：继续 或 新建
IF 用户已指定 --wiki 参数:
→ 直接使用指定的 Wiki，跳过搜索
ELSE IF 当前会话已执行过 /wf-search:
→ 复用已有搜索结果和上下文
→ 提示用户："已复用之前 /wf-search 的结果，是否重新搜索？"
→ 如果用户选择重新搜索，执行下方搜索流程
ELSE:
→ 自动提取关键词
→ 搜索 {paths.wiki}/{wiki.structure.current}/
→ 计算匹配度
IF 匹配度 >= 80%:
→ 显示匹配结果，要求确认：
"找到相关 Wiki：current/authentication.md（匹配度：95%）"
[ ] 使用此 Wiki
[ ] 查看详情（执行 /wf-search）
[ ] 手动选择其他 Wiki
ELSE IF 匹配度 40%-80%:
→ 显示候选列表，要求选择：
"找到以下可能的 Wiki："
1. current/authentication.md（匹配度：65%）
2. current/user-management.md（匹配度：45%）
[ ] 选择 1
[ ] 选择 2
[ ] 先 /wf-search 了解详情
[ ] 手动输入
ELSE:
→ 未找到相关 Wiki
→ 强制先执行 /wf-search：
"未找到相关 Wiki，请先执行 /wf-search 了解背景"
→ 自动执行 /wf-search
→ 搜索完成后回到匹配流程
根据用户输入的标题和描述，AI 询问以下信息：
新功能开发：
Q: 为什么要做这个功能？
Q: 当前系统有什么问题？
Q: 新方案是什么？
Q: 会影响哪些现有功能？
Q: 有没有需要废弃的功能？
Bug 修复：
Q: Bug 的具体表现是什么？
Q: 期望的正确行为是什么？
Q: 复现步骤是什么？
Q: 影响范围有多大？
需求改进：
Q: 当前实现有什么不足？
Q: 改进方案是什么？
Q: 会影响哪些现有功能？
Q: 需要废弃哪些旧功能？
AI 根据标题和描述自动判断类型（新功能/Bug/改进），只询问相关问题。用户也可以主动提供完整信息，跳过询问。
按照 references/spec.md 模板生成（使用 config.language 指定的语言）：
{paths.changes}/active/{slug}/spec.md
slug 生成规则：
{YYYY-MM-DD}-{slug}2026-04-24-add-registration按照 references/tasks.md 模板生成（使用 config.language 指定的语言）：
{paths.changes}/active/{slug}/tasks.md
AI 根据询问结果自动分解任务，按模块分组。
✅ 计划已生成
相关 Wiki：
→ current/authentication.md
生成文件：
→ docs/changes/active/2026-04-24-add-registration/spec.md
→ docs/changes/active/2026-04-24-add-registration/tasks.md
下一步：
→ /wf-do 开始执行开发
→ /wf-search 了解更多背景
必须指定相关 Wiki
## 相关 Wiki 字段spec.md 不可跳过
slug 唯一性
# {标题}
## 元数据
- 创建时间：{YYYY-MM-DD}
- 状态：active
- 相关 Wiki：{wiki-path}（匹配度：{score}%）
## 目标
{从询问中提取}
## 当前问题
{从询问中提取}
## 方案
{从询问中提取}
## 废弃功能
{从询问中提取，没有则写"无"}
## 影响范围
{从询问中提取}
## 相关链接
- [[{wiki-name}]]
执行开发计划，按照 tasks.md 逐个完成任务。自动检查 spec.md 是否存在，不存在则先执行 /wf-plan。
编译 Wiki，将 active 变更同步到知识库。自动处理历史版本、废弃功能、决策日志，并执行 lint 检查。完成后清理 active 目录。
修正开发过程中的问题和需求改进。AI 自动判断是 bug 还是需求改进，更新 spec.md 和 tasks.md，生成 decisions.md。仅在 /wf-do 之后使用。
初始化 WikiFlow 项目。对话确认配置，创建目录结构，生成 config.json。是使用 WikiFlow 的第一步。
检查 Wiki 文档质量。查找错误、矛盾点、孤岛文件、废弃残留等。优先检查 current/，必要时扩展到 history/。
查询 Wiki 知识库，了解当前系统实现和历史决策。在制定计划前了解背景，或随时查询项目文档。