القائمة
修正开发过程中的问题和需求改进。AI 自动判断是 bug 还是需求改进，更新 spec.md 和 tasks.md，生成 decisions.md。仅在 /wf-do 之后使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
执行开发计划，按照 tasks.md 逐个完成任务。自动检查 spec.md 是否存在，不存在则先执行 /wf-plan。
编译 Wiki，将 active 变更同步到知识库。自动处理历史版本、废弃功能、决策日志，并执行 lint 检查。完成后清理 active 目录。
初始化 WikiFlow 项目。对话确认配置，创建目录结构，生成 config.json。是使用 WikiFlow 的第一步。
检查 Wiki 文档质量。查找错误、矛盾点、孤岛文件、废弃残留等。优先检查 current/，必要时扩展到 history/。
制定开发计划，生成 spec.md 和 tasks.md。自动匹配相关 Wiki，强制文档先行。适用于新功能开发、bug 修复、需求改进。不可跳过。
查询 Wiki 知识库，了解当前系统实现和历史决策。在制定计划前了解背景，或随时查询项目文档。
| name | wf-fix |
| description | 修正开发过程中的问题和需求改进。AI 自动判断是 bug 还是需求改进，更新 spec.md 和 tasks.md，生成 decisions.md。仅在 /wf-do 之后使用。 |
| metadata | {"version":"1.0.0","execution_location":"documentation_repository"} |
⚠️ 重要约束：本技能在文档仓库执行，如需修改代码则通过 paths.code 操作代码仓库
在开发过程中修正 bug 或处理需求改进，确保文档和代码保持同步。
# 描述修正内容
/wf-fix "注册后应该自动登录，不需要再跳转到登录页"
# Bug 修复
/wf-fix "注册页面提交按钮点击无响应"
# 带更多上下文
/wf-fix "用户反馈注册后跳转到登录页体验差，改为注册后直接进入首页"
读取 .wikiflow/config.json，获取路径和语言配置。
检查是否有 active 变更：
→ 扫描 {paths.changes}/active/
→ 没有则提示"请先执行 /wf-plan 和 /wf-do"
**检查当前仓库类型**：
检查当前目录特征：
IF 存在 .wikiflow/config.json AND docs/wiki/ 目录:
→ 当前是文档仓库
→ ✅ 继续执行
ELSE:
→ ⚠️ 警告：当前目录不是文档仓库
→ 提示用户："wf-fix 需要在文档仓库执行（修改 spec.md、tasks.md）
当前目录：{当前目录}
文档仓库特征：存在 .wikiflow/config.json 和 docs/wiki/
请切换到文档仓库后重试"
→ 退出执行
**操作约束检查**（AI 执行时必须遵守）：
✅ 允许的操作：
→ 读取/修改文档仓库：spec.md、tasks.md、decisions.md、wiki/
→ 修改代码仓库：通过 paths.code 路径操作代码文件（../wikiflow/src/*）
❌ 禁止的操作：
→ 在文档仓库修改代码文件（文档仓库不应该有代码文件）
→ 在代码仓库修改文档文件（spec.md、tasks.md 必须在文档仓库）
AI 分析用户描述，自动判断是 Bug 还是需求改进：
判断标准：
| 类型 | 判断依据 | 处理方式 |
|---|---|---|
| Bug | 修复错误，不改变 spec.md 的目标 | 只更新 tasks.md，修改代码 |
| 需求改进 | 影响 spec.md 的目标，需要修改设计 | 更新 spec.md + tasks.md + 生成 decisions.md + 修改代码 |
AI 分析过程：
分析输入："{用户描述}"
对比当前 spec.md：
→ 是否改变目标？ → 是 → 需求改进
→ 是否只是修复？ → 是 → Bug
判断结果：{type}
理由：{reason}
IF type === "bug":
1. 通过 paths.code 定位代码仓库，修复 bug（修改代码）
2. 更新文档仓库中的 tasks.md：
→ 在 [Bug 修复] 分组下添加新任务
→ 标记为已完成
3. 输出：
✅ Bug 已修复
更新文件：tasks.md
IF type === "requirement":
1. 更新文档仓库中的 spec.md：
→ 在"方案"部分添加新的改进
→ 在"废弃功能"部分添加被废弃的内容（如果有）
→ 更新"影响范围"
2. 更新文档仓库中的 tasks.md：
→ 在相应分组下添加新任务
→ 或修改现有任务的描述
3. 在文档仓库中生成 decisions.md：
→ 按照模板生成决策记录
→ 追加到现有 decisions.md（如果已存在）
→ 或创建新的 decisions.md
4. 通过 paths.code 定位代码仓库，执行代码修改
5. 输出：
✅ 需求改进已处理
更新文件：
→ spec.md（更新目标）
→ tasks.md（添加任务）
→ decisions.md（新增决策）
✅ 修正完成
类型：需求改进
决策：注册后自动登录，不再跳转到登录页
更新文件：
→ spec.md：添加"注册后自动登录"
→ tasks.md：添加"实现注册后自动跳转"
→ decisions.md：新增 [2026-04-24 15:30] 注册后自动登录
下一步：
→ /wf-do 继续执行剩余任务
→ 或 /wf-finish 如果所有任务已完成
每次需求改进都追加一条决策记录：
## [{YYYY-MM-DD HH:MM}] {简短标题}
### 问题
{为什么要改}
### 决策
{改了什么}
### 废弃
- ❌ {被废弃的功能}（如果有）
### 新增
- ✅ {新增的功能}
### 影响文档
- spec.md：{更新了什么}
- tasks.md：{添加了什么}
### 影响代码
- {文件路径}
执行位置：
操作边界：
执行规范：