用途:把用户从安装 nao-core 带到同步完成的 nao 项目,并生成一份起步用的 RULES.md。共六步。
主要能力:第一步一次性询问仓库类型与凭据、表范围(宽口径金层/跨域,或深口径单域银层加金层)、额外上下文(dbt/ETL/BI 仓库的 SSH git 地址、Notion、内部文档)以及 LLM 提供商与密钥。第二步从 docs.getnao.io/nao-agent/context-builder/databases 查各仓库所需字段(如 BigQuery 需 project_id、dataset_id 可选;Snowflake 需 account_id、warehouse、schema_name 可选),写 nao_config.yaml 后运行 nao init --no-tty,并向用户打印配置摘要请其确认。第三步执行 nao sync。第四步直接交给 write-context-rules 生成 RULES.md。第五步配置 LLM 密钥,推荐用环境变量引用。第六步建议做冒烟测试、检查 RULES.md 并选择后续技能。
使用方式:所有 nao 命令需在存放 nao_config.yaml 的目录执行。示例命令:unset ANTHROPIC_BASE_URL ANTHROPIC_API_KEY && source ~/.zshrc 2>/dev/null; nao init --no-tty 2>&1;nao sync;nao chat;nao debug。模板字段写 templates: [columns, preview]。
限制:表数上限约 100,20 为理想目标,超出会拖慢同步并压缩单表上下文预算;仓库地址只支持 SSH git URL,不支持本地路径;不要使用已弃用的 accessors;不要让用户在聊天中粘贴 LLM 密钥;nao init 必须带 --no-tty。若 nao chat/debug/test 报 AI_APICallError: Not Found 且 URL 为 https://api.anthropic.com/messages,说明父级智能体 CLI 泄漏了 ANTHROPIC_BASE_URL,可用上述 unset 命令修复。模型在 nao UI 中选择,不写进 nao_config.yaml。具体收费、价格与效果暂未提供。