菜单
检查 Wiki 文档质量。查找错误、矛盾点、孤岛文件、废弃残留等。优先检查 current/，必要时扩展到 history/。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | wf-lint |
| description | 检查 Wiki 文档质量。查找错误、矛盾点、孤岛文件、废弃残留等。优先检查 current/，必要时扩展到 history/。 |
| metadata | {"version":"1.0.0","execution_location":"documentation_repository"} |
⚠️ 重要约束：本技能必须在文档仓库中执行
检查 Wiki 知识库中的文档质量问题，包括错误、矛盾、孤岛页面、废弃残留等。
# 检查所有 Wiki 文档
/wf-lint
# 只检查 current/ 目录
/wf-lint --scope current
# 检查 current/ + history/
/wf-lint --scope full
# 检查指定页面
/wf-lint current/authentication
读取 .wikiflow/config.json：
→ 获取 paths.wiki、wiki.structure、language 等配置
**检查当前仓库类型**：
检查当前目录特征：
IF 存在 .wikiflow/config.json AND docs/wiki/ 目录:
→ 当前是文档仓库
→ ✅ 继续执行
ELSE:
→ 当前不是文档仓库
→ ❌ 错误：wf-lint 必须在文档仓库执行
→ 报错并提示切换到文档仓库
→ 退出执行
扫描 {paths.wiki}/{wiki.structure.current}/ 下所有 .md 文件：
→ 读取每个文件的 frontmatter 和内容
→ 构建页面索引（标题、标签、链接、引用关系）
按优先级依次执行：
FOR 每个 current/ 中的页面:
→ 内容中是否包含 ⚠️ 或"已废弃"标记？
→ frontmatter 中 tags 是否包含 deprecated 相关标签？
→ 如果有 → 该页面应移到 deprecated/，标记为问题
输出：{N} 个页面包含废弃标记但仍在 current/ 中
FOR 每个页面中的 [[link]] 引用:
→ 目标文件是否存在？
→ 不存在 → 记录为失效链接
→ 搜索可能的替代页面（关键词匹配）
→ 给出修复建议
输出：{N} 个失效链接
FOR 每对相关页面（通过 tags 或 [[link]] 关联）:
→ 同一功能在不同页面中的描述是否矛盾？
→ 决策记录是否与 current/ 中的实现描述一致？
→ 如果矛盾 → 标记并给出具体冲突点
输出：{N} 处内容矛盾
FOR 每个 current/ 中的页面:
→ 是否被其他页面通过 [[link]] 引用？
→ 是否被 index.md 列出？
→ 如果都没有 → 标记为孤岛页面
→ 检查孤岛页面内容是否仍有价值：
- 有价值 → 建议从其他页面添加引用
- 无价值 → 建议移到 deprecated/
输出：{N} 个孤岛页面
FOR 每个页面的 frontmatter:
→ 必填字段是否完整？（对照 references/docs.schema.json）
→ date 格式是否正确？（YYYY-MM-DD）
→ type 值是否合法？
→ 如果有问题 → 标记具体缺失字段
输出：{N} 个 frontmatter 问题
IF --scope full:
扫描 {paths.wiki}/{wiki.structure.history}/:
→ history/ 中是否有与 current/ 同名但内容完全相同的页面？
→ 冗余历史版本，建议删除
→ history/ 版本数量是否超过 keepHistoryVersions？
→ 超出则标记最旧的版本建议清理
扫描 {paths.wiki}/{wiki.structure.deprecated}/:
→ deprecated/ 中是否有被 current/ 重新引用的功能？
→ 可能需要恢复或更新引用
→ replaced_by 指向的页面是否存在？
输出：{N} 个历史版本问题
📋 Wiki 文档质量报告
检查范围：current/（{N} 页）
history/（{N} 页，仅 --scope full）
✅ 废弃残留：通过
✅ 链接完整性：通过
⚠️ 内容矛盾：发现 2 处
→ current/auth.md 与 current/login.md 对"密码规则"描述不一致
→ decisions/2026-04-20-xxx.md 中的决策未反映在 current/auth.md
❌ 孤岛页面：发现 1 个
→ current/payment-utils.md（无任何页面引用）
✅ frontmatter 规范：通过
✅ 历史版本一致性：通过
总计：6 项检查，4 项通过，1 项需关注，1 项需修复
建议操作：
→ /wf-finish 可自动修复废弃残留和部分链接问题
→ 内容矛盾和孤岛页面需手动确认后通过 /wf-plan 处理
询问用户是否自动修复可修复的问题：
[ ] 自动修复（废弃残留、失效链接、frontmatter）
[ ] 仅标记，不修复
[ ] 逐项确认后修复
/wf-plan → /wf-finish 修复/wf-do 配合处理执行开发计划，按照 tasks.md 逐个完成任务。自动检查 spec.md 是否存在，不存在则先执行 /wf-plan。
编译 Wiki，将 active 变更同步到知识库。自动处理历史版本、废弃功能、决策日志，并执行 lint 检查。完成后清理 active 目录。
修正开发过程中的问题和需求改进。AI 自动判断是 bug 还是需求改进，更新 spec.md 和 tasks.md，生成 decisions.md。仅在 /wf-do 之后使用。
初始化 WikiFlow 项目。对话确认配置，创建目录结构，生成 config.json。是使用 WikiFlow 的第一步。
制定开发计划，生成 spec.md 和 tasks.md。自动匹配相关 Wiki，强制文档先行。适用于新功能开发、bug 修复、需求改进。不可跳过。
查询 Wiki 知识库，了解当前系统实现和历史决策。在制定计划前了解背景，或随时查询项目文档。