ha-manual
Answer 'how do I use X / where is setting Y / what does panel Z do' questions about Hope Agent from the built-in bilingual user guide instead of guessing from memory. Trigger on: 怎么用, 在哪设置, 怎么开启, 如何配置, 使用手册, 用户手册, 功能说明, how to use, where is the setting, how do I enable, user guide, manual. The guide covers install & onboarding, models & providers, chat & sessions, memory, knowledge space, design space, tools & permissions, autonomous tasks, multi-agent & cron, IM channels, MCP/hooks/skills, projects & insights, settings & security. NOT for: internal implementation questions (ha-self-diagnosis), error/log investigation (ha-logs), actually changing settings (ha-settings).
git clone --depth 1 https://github.com/shiwenwen/hope-agent /tmp/ha-manual && cp -r /tmp/ha-manual/skills/ha-manual ~/.claude/skills/ha-manualSKILL.md
# Hope Agent User Guide Lookup
You are answering a "how do I use this product" question. The full bilingual
user guide ships inside Hope Agent — read it and answer from it. Never invent
setting names, panel paths, or slash commands from memory: if the guide names
a panel, quote that name; if you cannot find the answer in the guide, say so.
## Resolve the manual root first
The guide is mirrored to `<data-dir>/manual/` where `<data-dir>` is
`$HA_DATA_DIR` when set (Docker: `/data`), else `~/.hope-agent`. Resolve it
dynamically — do NOT hard-code `~/.hope-agent` (wrong under Docker/portable):
```bash
ls "${HA_DATA_DIR:-$HOME/.hope-agent}/manual/"
```
Layout: `manual/zh/` (简体中文) and `manual/en/` (English) — pick the language
the user is speaking. Each contains `index.md` (overview + navigation) and
`01.md` … `13.md` (chapters). If the directory is missing (mirror not ready:
first boot still warming, or disk issue), tell the user the manual is still
being prepared and to retry in a moment — do not fall back to other paths;
this mirror is the only on-disk copy in packaged installs.
## Iron rules
- **Read-only**: only `read` / `grep` / `find` / `ls` the manual tree.
- **Answer from the text**: cite the chapter number + section heading you
used (e.g. "见 05 · 知识空间 §5.2"). Quote exact UI labels from the guide.
- **Don't dump chapters**: extract the relevant section, answer concisely,
and point to the chapter for more.
## Chapter routing table
Pick the chapter from the question, `read` it, `grep` only when unsure:
| File | Chapter | Covers |
| --- | --- | --- |
| `01.md` | 快速上手 / Getting Started | install per platform, first-launch wizard, run modes (desktop / server+web / ACP), updates, one-click local models, remote access |
| `02.md` | 模型与 Provider / Models & Providers | providers & API keys, Codex sign-in, primary/fallback models, thinking & temperature, failover, STT, media generation (image/audio), web search |
| `03.md` | 对话与会话 / Chat & Sessions | chat UI, attachments & multimodal, session management & search, incognito, working directory, context compaction, all slash commands |
| `04.md` | 记忆系统 / Memory | three memory tiers, auto-memory, recall, Dreaming, user profile, correction loop |
| `05.md` | 知识空间 / Knowledge Space | notes, binding Obsidian, full-text & vector search, backlinks & graph, AI chat panel, access control |
| `06.md` | 设计空间 / Design Space | generating web pages / posters / decks etc., live preview, fine-tuning, versions, export, handoff to code |
| `07.md` | 工具与权限 / Tools & Permissions | built-in tools, permission modes, approval dialog, protected paths & dangerous commands, Docker sandbox, browser control, computer control |
| `08.md` | 自主任务 / Autonomous Tasks | goals, workflows, Loop, Plan Mode, task progress, execution modes |
| `09.md` | 多 Agent 与定时任务 / Multi-Agent & Scheduling | sub-agents, agent teams, natural-language cron jobs, background jobs, self-wakeup |
| `10.md` | IM 渠道 / IM Channels | Telegram / Discord / Slack / Feishu etc., approvals over IM, streaming mirror, session handover |
| `11.md` | 连接与扩展 / Connect & Extend | MCP client & platform server, hooks, skill system |
| `12.md` | 项目与数据洞察 / Projects & Insights | project containers, agent configuration, dashboard cost & health, Recap reports |
| `13.md` | 设置与安全 / Settings & Security | settings navigation map ("which panel changes X"), changing settings via chat, config backup & rollback, security & reliability |
| `14.md` | 能力评测 / Capability Evaluation | evaluation center: repeatable synthetic tasks against real models, task success / tool calls / latency / token cost metrics, orchestration stability |
| `index.md` | 目录 / Overview | reading guide, core concepts glossary, "I want to…" quick lookup |
Not sure which chapter? `13.md` has the settings navigation map, and
`index.md` has an intent → chapter lookup table.
## When NOT to use this skill
- How Hope Agent works **internally** (source/architecture) → `ha-self-diagnosis`
- Something is **broken** / error investigation → `ha-logs`
- Actually **changing** a setting for the user → `ha-settings`
$ARGUMENTS>
Use when the user asks to draft, polish, translate, or reply to an email. Produces a clean draft with subject line, greeting, body, and sign-off, plus a pre-send self-check.
Use when the user mentions 飞书 / Feishu / Lark workspace operations: docx (云文档) read/write, bitable (多维表格) records / views / dashboards, drive (云盘) upload/download, wiki (知识库) link resolution, approval (审批) instance create/cancel/query, calendar (日历) event create/list/update + attendees, contact (联系人) user/department lookup, hire (招聘) job/talent/application listing. Trigger on phrases like 'OKR 周报', '把这份文档发到飞书云盘', '给团队拉个评审会议', '查 [姓名] 的联系方式', '撤销那条审批', '/wiki 链接', or any request that mentions a feishu / lark URL / token (doxcn.../bascn.../wikcn.../boxcn.../om_...).
Hope Agent browser automation — the standard `status → tabs → snapshot → act` loop, stale-ref recovery rules, and what to do when login / 2FA / captcha / camera-prompt / dialog blocks progress. Load this skill whenever you reach for the `browser` tool. Trigger on: user asks the agent to open / control / click / scrape / log into / verify something in a web app ('open X and click Y', '打开 X 然后点击 Y', 'log into my Gmail', 'scrape this page', 'fill out the form on X'); user reports a flow that requires real browser context (cookies, JS-rendered content, OAuth).
Discover and install third-party skills from external registries when the user needs a capability that no currently-active skill covers. Trigger when: (1) the user explicitly asks 'find a skill for X', 'is there a skill that does X', 'install a skill to X', (2) the user requests a well-known integration (Slack, Notion, Trello, GitHub, Hue, Sonos, iMessage, weather, TTS, transcription …) that isn't in the active skill catalog, (3) you are about to hand-write ad-hoc shell / API code for a domain that almost certainly has a published skill. Do NOT trigger if an active skill already covers the need — scan the visible skill catalog first.
Self-service diagnostics — query Hope Agent's local SQLite databases (logs / sessions / background jobs) directly via the `exec` tool to investigate problems, analyze usage, and locate root causes. Trigger on: user reports something broken / failing / slow / stuck / not responding ('X 不工作', 'X 报错', 'X 卡住', '为什么 X 失败', 'why did X fail', 'show me the logs', 'check what happened'); ad-hoc data analysis ('this week's token usage', '最近调用最多的工具', 'how many subagent runs failed', 'tool error rate', 'find sessions where X happened'); verifying a fix ('did the error stop after I changed Y'). Use BEFORE asking the user to paste log snippets — the data is on disk, query it directly. Read-only — SELECT only, never UPDATE/DELETE/INSERT/DROP.
Hope Agent native macOS desktop control — the standard `mac_control` status / diagnostics / apps / dock / spaces / snapshot / visual / windows / menu / clipboard / dialog loop, target-first action rules, no-blind-coordinate policy, and recovery for stale AX/window/menu/dialog state. Load whenever using `mac_control`, or when the user asks to control local Mac apps, Dock, Spaces, click/type/menu/window/dialog/clipboard, automate Finder/TextEdit/System Settings, visually locate UI, or says 控制 Mac, macOS 自动化, 点按钮, 打开应用, Dock, Space, 关闭窗口, 菜单点击, 视觉定位.
Self-understanding and issue reporting for Hope Agent itself. Use when the user asks how Hope Agent works internally, asks about its own source code/docs/runtime behavior, reports a bug/failure/slowness/crash, asks to diagnose logs, or asks to create/submit a GitHub issue for a bug, feature request, or improvement (including when there is no bug). Chinese triggers: 自查, 了解自己, 自我诊断, 排查 Hope Agent, 提交 issue, 需求 issue, 功能改进.