Anydocs Documents
CLI 命令

init - 初始化项目

用 CLI 创建新的 Anydocs 文档项目。

`init` 用来创建一个新的文档项目根目录。对交付用户站点或交付给 AI 协作来说,第一步都应该是先得到一个干净的 project root,而不是在现有目录里反复执行初始化。

最短路径

npx @anydocs/cli init ./my-docs

初始化完成后,直接打开 `./my-docs`,编辑页面并把目标页面设为 `published`,再用 `preview` 检查 reader 效果。

AI 交付模式

如果项目从一开始就要让 AI 参与写作,在初始化时指定 agent,让 CLI 生成对应的项目内 guide 文件。

npx @anydocs/cli init ./my-docs --agent codex
npx @anydocs/cli init ./my-docs --agent claude-code

默认情况下,不显式指定 `--agent` 时会生成 `skill.md`。

初始化后会生成什么

  • `anydocs.config.json`
  • `anydocs.workflow.json`
  • `pages/<lang>/welcome.json` 等起步页面
  • `navigation/<lang>.json`
  • 默认 guide: `skill.md`
  • `--agent codex`: `AGENTS.md`
  • `--agent claude-code`: `CLAUDE.md` 和 `.claude/commands/`

什么时候不要再执行 `init`

如果目标目录里已经有 `anydocs.config.json`,说明它已经是一个文档项目。此时应该直接打开项目、编辑页面或运行 `preview` / `build`,而不是再次初始化。