Menu
初始化 WikiFlow 项目。对话确认配置，创建目录结构，生成 config.json。是使用 WikiFlow 的第一步。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
执行开发计划，按照 tasks.md 逐个完成任务。自动检查 spec.md 是否存在，不存在则先执行 /wf-plan。
编译 Wiki，将 active 变更同步到知识库。自动处理历史版本、废弃功能、决策日志，并执行 lint 检查。完成后清理 active 目录。
修正开发过程中的问题和需求改进。AI 自动判断是 bug 还是需求改进，更新 spec.md 和 tasks.md，生成 decisions.md。仅在 /wf-do 之后使用。
检查 Wiki 文档质量。查找错误、矛盾点、孤岛文件、废弃残留等。优先检查 current/，必要时扩展到 history/。
制定开发计划，生成 spec.md 和 tasks.md。自动匹配相关 Wiki，强制文档先行。适用于新功能开发、bug 修复、需求改进。不可跳过。
查询 Wiki 知识库，了解当前系统实现和历史决策。在制定计划前了解背景，或随时查询项目文档。
| name | wf-init |
| description | 初始化 WikiFlow 项目。对话确认配置，创建目录结构，生成 config.json。是使用 WikiFlow 的第一步。 |
| metadata | {"version":"1.0.0","execution_location":"any"} |
初始化 WikiFlow，在用户项目中创建文档驱动的开发环境。
核心理念：文档与代码分离 - 人类通过文档指挥 AI，AI 完全接管代码实现。详见 架构文档。
# 初始化当前项目
/wf-init
# 仅初始化环境变量文件
/wf-init --env
# 初始化指定项目
/wf-init /path/to/project
WikiFlow 基于文档与代码分离架构：
核心思想：
.wikiflow/config.json 建立关联职责划分：
文档仓库：
代码仓库：
了解更多：文档与代码分离架构
向用户询问以下信息：
Q: 这是文档仓库还是代码仓库？
[ ] 文档仓库（创建 .wikiflow/，配置代码仓库路径）
[ ] 代码仓库（跳过初始化，引用外部文档仓库）
如果选择文档仓库：
Q: 项目名称是什么？
Q: 有几个代码仓库需要关联？
- 单仓库：直接配置代码路径
- 多仓库：配置每个仓库的名称和路径
Q: 代码路径使用默认值还是环境变量？
[ ] 默认值（适合单仓库或团队成员目录结构一致）
[ ] 环境变量（适合团队协作，每个人目录结构不同）
Q: 主要编程语言是什么？（用于 AI 理解代码）
Q: 工作流使用什么语言？（默认 zh-CN）
Q: 文档放在哪个目录？（默认 docs/）
如果选择环境变量：
Q: 是否创建 .env 模板文件？
根据回答生成配置。如果选择环境变量，config 中使用 ${WIKIFLOW_XXX_ROOT:-默认值} 格式。
检查项目根目录下是否已有 {docs} 目录：
IF 不存在:
→ 直接创建
IF 已存在:
→ 询问用户：
[ ] 使用现有目录（将 WikiFlow 结构添加进去）
[ ] 改名旧目录为 {docs}-old，创建新的
[ ] 指定其他目录名
{docs}/
├── wiki/
│ ├── current/ ← 当前实现（AI 查询优先读这里）
│ ├── history/ ← 历史版本
│ ├── deprecated/ ← 已废弃功能
│ ├── decisions/ ← 决策日志
│ ├── index.md ← 主索引
│ └── log.md ← 变更日志
├── raw/
│ └── 00-uncategorized/ ← 原始文档（存量系统）
└── changes/
└── active/ ← 开发中的变更
# Wiki 知识库索引
本索引由 WikiFlow 自动生成和维护。
## 当前实现（current/）
| 页面 | 标签 | 最后更新 |
|------|------|----------|
| （暂无页面，执行 /wf-finish 后会自动更新） | | |
## 历史版本（history/）
| 页面 | 版本 | 归档日期 |
|------|------|----------|
| （暂无历史版本） | | |
## 已废弃（deprecated/）
| 页面 | 废弃日期 | 替代方案 |
|------|----------|----------|
| （暂无废弃功能） | | |
## 决策日志（decisions/）
| 日期 | 决策标题 | 相关功能 |
|------|----------|----------|
| （暂无决策记录） | | |
---
统计：current 0 页 | history 0 页 | deprecated 0 页 | decisions 0 条
# Wiki 变更日志
本日志由 WikiFlow 自动生成和维护。
---
（暂无变更记录，执行 /wf-finish 后会自动追加）
检查项目根目录下是否有 .gitignore 文件：
IF 不存在:
→ 创建 .gitignore
→ 添加内容：.env、.env.local
IF 已存在:
→ 读取现有内容
→ 检查是否已包含 .env、.env.local
→ IF 没有:
→ 追加以下内容：
# WikiFlow environment variables
.env
.env.local
→ 提示用户："✅ 已在 .gitignore 中追加 .env 相关条目"
→ ELSE:
→ 提示用户："ℹ️ .gitignore 已包含 .env 相关条目，跳过"
复制 references/.env.template 到项目根目录的 .env.example：
→ .env.example 是静态模板，展示环境变量的使用方式
→ 团队成员可以参考此文件创建自己的 .env
如果是 --env 模式：
读取项目根目录的 .env.example 文件
IF .env.example 不存在:
→ 提示用户："未找到 .env.example，请先执行 /wf-init 生成模板"
→ 退出
IF .env.example 存在:
→ 询问用户："是否创建或更新 .env 文件？"
[ ] 创建 .env（如果不存在）
[ ] 更新 .env（如果已存在，覆盖或合并）
IF 用户选择创建/更新:
→ 读取 .env.example 中的环境变量说明
→ 提取环境变量名称（WIKIFLOW_XXX_ROOT 格式）
→ 生成 .env 文件（或更新现有 .env）
→ 对于 .env.example 中的注释和示例，生成对应的 .env 内容
→ 提示用户："✅ .env 文件已创建/更新，请填入你的实际路径"
输出：
→ .env 文件路径
→ 提示用户编辑 .env 填入实际路径
多仓库配置示例：
{
"project": {
"name": "my-project",
"code": {
"repositories": [
{"name": "backend", "root": "${WIKIFLOW_BACKEND_ROOT:-../backend-code}/src"},
{"name": "frontend", "root": "${WIKIFLOW_FRONTEND_ROOT:-../frontend-code}/src"}
]
}
}
}
单仓库配置示例：
{
"project": {
"name": "my-project",
"code": {
"root": "src"
}
}
}
✅ WikiFlow 初始化完成
配置文件：
→ .wikiflow/config.json
创建目录：
→ docs/wiki/{current,history,deprecated,decisions}
→ docs/raw/00-uncategorized
→ docs/changes/active
生成文件：
→ docs/wiki/index.md
→ docs/wiki/log.md
→ .env.template（如果选择环境变量）
下一步：
→ 如使用环境变量，复制 .env.template 为 .env 并填入路径
→ /wf-plan "你的第一个功能" 开始开发
→ 或将现有文档放入 docs/raw/ 后通过 /wf-plan 整理到 Wiki
raw/ 目录，后续通过工作流整理project.code 是面向 AI 的配置，用户无需关心代码细节如果 config 中使用了环境变量（如 ${WIKIFLOW_BACKEND_ROOT:-../backend}），所有 skill 在执行时会：
这样团队成员可以各自设置不同的代码路径，而不会在 config.json 上冲突。