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`,而不是再次初始化。