Menü
初始化 WikiFlow 项目。对话确认配置，创建目录结构，生成 config.json。是使用 WikiFlow 的第一步。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
执行开发计划，按照 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 上冲突。