用途:为仓库、GitHub URL 或本地路径生成更高质量的自定义 Grok-Wiki。核心理念是“先问意图,再写提示,最后生成”,适合需要面向特定读者和目标的定制化技术文档。
主要能力与工作流:
- 确认生成意图:若用户已给出明确意图、受众、页数、来源和 agent,则直接进行;若缺少意图,先问一个简短问题:“Who is this wiki for, and what should it help them do?”。页数缺失时不要预设默认值,交给 ask 从仓库规模、复杂度和意图推荐。
- 探测仓库:运行 grok-wiki ask <source> "<discovery question>" --mode deep,可加 --agent <id>。询问产品目的、架构、关键工作流、重要实现区域、贡献风险,以及针对既定意图最有价值的页面计划,并让 ask 推荐大致页数或范围。
- 编写自定义风格提示:写入本地文件(如 .grok-wiki-<repo>-custom-prompt.md;远程来源可写到 $TMPDIR 下,--style-prompt-file 接受绝对路径)。提示需点明受众、结果、页数、页面标题和质量标准。
- 生成:运行 grok-wiki generate <source> --agent <id> --page-count-mode fixed --pages <N> --style custom --style-prompt-file <prompt-file>,未选 agent 时省略 --agent。
- 验证:等待命令成功退出,运行 grok-wiki list,检查生成报告保存的 JSON 路径;在桌面应用中尽量确认 wiki 出现在库或最近列表。
限制与注意事项:需先按 grok-wiki-cli 技能确认 CLI 可用性、本地 agent 就绪情况、命令语法与回退方式;生成与 Ask 必须保持本地 CLI/BYOC/BYOK,不要求提供商 API 密钥,也不切换云提供商。若本地 agent 未就绪,运行 grok-wiki agents --rescan 并报告设置提示,不要静默更换 agent。若 Ask 成功但生成失败,保留提示文件并报告失败命令。其他收费、价格、平台等细节暂未提供。