| name | snow-app-docs |
| description | Snow App 配置与排查向导（中文/English）——配置/管理 API 密钥、模型与档案、 MCP 服务器、Skills、子代理、Hooks、图像生成、代理与网络、全局站点拦截规则、第三方配置导入、 安全隐私与工具授权、个性化/系统提示词/自定义请求头/主题/快捷键、用量统计与 系统日志、数据存储位置、settings.json 字段、内置工具等。 Guides the agent to read the built-in Snow App documentation (~/.snow/docs) before configuring or troubleshooting Snow App. Covers MCP servers; installing, managing, creating, and authoring Skills; sub-agents; Hooks; API keys/models; image generation; proxy/network; third-party config and Plugin runtimes; browser passwords and local-browser data import; app updates; security/privacy/tool authorization; personalization, system prompts, custom headers, themes, and shortcuts; usage/log diagnostics; project-scoped settings; settings.json fields; storage locations; and built-in tools. Use this Skill whenever the user asks to configure, inspect, create, author, or troubleshoot any of these areas. It covers the config built-in service (config-list/get/set/delete; scopes: settings/snowcfg/proxy/app/ custom-headers/system-prompt/theme/language/permissions/lsp-config/buddy/ subAgents/hooks/skills/logs/imagegen/personalization/apiProfiles), including project-scoped mcpServers/sensitiveCommands/subAgents/hooks/skills via `projectId`, the read-only logs scope, imagegen multi-channel settings, masked secrets, and app-control-openSettings (21 settings pages). |
| enable | true |
| allowed-tools | ["config-list","config-get","config-set","config-delete","user-interaction-askUserQuestion","app-control-openSettings","app-control-getBlockedPatterns","app-control-updateBlockedPatterns","bash-terminal-execute","filesystem-read","filesystem-replace_edit","filesystem-create","websearch-websearch-search","websearch-websearch-fetch"] |
Snow App 文档阅读与配置指导（Docs & Configuration Guide）
当用户请求配置 MCP 服务器、安装与管理 Skills、创建与编写 Skills、配置 Hooks
与子代理、配置 API 密钥与模型、配置图像生成、配置代理与网络、导入第三方配置
与插件、管理浏览器密码/数据、处理应用更新、个性化与自定义请求头、用量/日志诊断、
项目级设置，或询问 settings.json 字段 / 内置工具 / 安全边界 / 数据位置时，
先阅读应用内置文档，再按文档步骤动手配置，而不是凭记忆操作。
1. 先读文档（Read the docs first）
文档随应用安装到 ~/.snow/docs/（Windows 为 C:\Users\<用户名>\.snow\docs\）。
先执行 config-list scope=language 读取界面语言（zh-CN/en/zh-TW），
再选择对应文档分支（无法读取时默认中文分支）：
- 中文界面 → 读
~/.snow/docs/zh-CN/
- English UI → read
~/.snow/docs/en/
按任务定位文档（路径相对所选语言分支）：
| 任务 | 使用指南（How-to） | 参考手册（Reference） |
|---|
| 快速开始（安装/首次运行/基础配置） | 1-快速开始.md（en: 1-getting-started.md） | — |
| 配置 MCP 服务器 | 2-使用指南/1-配置MCP服务器.md（en: 2-guides/1-configure-mcp.md） | 3-参考手册/1-settings.json配置参考.md |
| 安装与管理 Skills | 2-使用指南/2-安装与管理Skills.md（en: 2-guides/2-install-and-manage-skills.md） | — |
| 创建与编写 Skills | 2-使用指南/21-创建与编写Skills.md（en: 2-guides/21-create-and-author-skills.md） | — |
| 配置 API 密钥与模型 | 2-使用指南/3-配置API密钥与模型.md#5（en: 2-guides/3-configure-api-keys.md#5；§5 为 agent 操作速查） | 3-参考手册/1-settings.json配置参考.md |
| 配置图像生成 | 2-使用指南/9-图像生成.md（en: 2-guides/9-image-generation.md） | 3-参考手册/2-内置工具参考.md（imagegen 章节与 config 的 imagegen scope） |
| 使用聊天与 AI 助手（界面/对话/命令/回滚/压缩） | 2-使用指南/10-使用聊天与AI助手.md（en: 2-guides/10-using-chat-and-ai.md） | — |
| 终端与 SSH 远程管理 | 2-使用指南/11-终端与SSH远程管理.md（en: 2-guides/11-terminal-and-ssh.md） |
