القائمة
从 OpenSpec 迁移到 WikiFlow。检测现有 OpenSpec 结构，转换配置、迁移 Wiki 和 specs。一次性使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | wf-migrate-openspec |
| description | 从 OpenSpec 迁移到 WikiFlow。检测现有 OpenSpec 结构，转换配置、迁移 Wiki 和 specs。一次性使用。 |
| metadata | {"version":"1.0.0"} |
检测项目中的 OpenSpec 结构，将数据迁移到 WikiFlow 格式。一次性使用，迁移完成后可卸载本技能。
openspec/ 目录/wf-init 初始化 WikiFlow/wf-migrate-openspec
扫描项目根目录，查找 openspec/ 目录：
IF 不存在:
→ 提示"未检测到 OpenSpec 结构，无需迁移"
→ 退出
IF 存在:
→ 读取 openspec/config.yaml
→ 列出检测到的内容：
- config.yaml
- docs/wiki/ 下的页面（统计数量）
- specs/ 下的规格文件（统计数量）
- docs/raw/ 下的原始文档（统计数量）
→ 要求用户确认迁移
将 openspec/docs/wiki/ 的内容迁移到 WikiFlow 的 docs/wiki/current/：
IF openspec/docs/wiki/features/ 存在:
→ 读取 features/ 下的每个 .md 文件
→ 为每个文件添加 WikiFlow frontmatter（type: feature, last_updated, tags）
→ 写入 docs/wiki/current/
IF openspec/docs/wiki/index.md 存在:
→ 读取内容，按 WikiFlow 索引格式重新生成 docs/wiki/index.md
IF openspec/docs/wiki/log.md 存在:
→ 追加到 docs/wiki/log.md
将 openspec/specs/ 下的规格文件迁移到 WikiFlow 格式：
FOR 每个规格文件:
→ 读取内容
→ 转换为 WikiFlow 的 spec.md 格式（按 wf-plan 的 references/spec.md 模板）
→ 如果是活跃规格 → 放入 {paths.changes}/active/{slug}/spec.md
→ 如果是已归档 → 直接编译到 {paths.wiki}/current/（WikiFlow 不保留 archive）
IF openspec/docs/raw/ 存在且非空:
→ 将内容合并到 docs/raw/00-uncategorized/
→ 如果有冲突（同名文件），保留两份并加后缀
IF openspec/changes/archive/ 存在且非空:
→ 将归档内容直接编译到 {paths.wiki}/current/（作为历史 Wiki 页面）
→ WikiFlow 不使用 archive 目录，归档内容统一由 Wiki 管理
IF openspec/docs/schema/CLAUDE.md 存在:
→ 复制到 docs/raw/00-uncategorized/openspec-claude-md（保留参考）
读取 openspec/config.yaml，提取有效配置：
→ 项目名称、路径等
→ 更新 .wikiflow/config.json 中对应字段
迁移完成后，询问用户：
[ ] 删除 openspec/ 目录（推荐，迁移已完成）
[ ] 重命名为 openspec-backup/（保留备份）
[ ] 暂不处理（稍后手动清理）
✅ OpenSpec → WikiFlow 迁移完成
迁移统计：
→ Wiki 页面：{N} 页 → {paths.wiki}/current/
→ 规格文件：{N} 个 → {paths.changes}/active/
→ 原始文档：{N} 个 → {paths.raw}/
下一步：
→ /wf-search "关键词" 验证迁移结果
→ /wf-plan 开始新的开发
执行开发计划，按照 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/。
制定开发计划，生成 spec.md 和 tasks.md。自动匹配相关 Wiki，强制文档先行。适用于新功能开发、bug 修复、需求改进。不可跳过。