git:20260909.cc0be4d to git:20260914.9bd7f1f

7 added, 3 removed. Audit A to A.

---

description: Horosa Skill MCP usage rules for Cursor agents

alwaysApply: true

---

# Horosa Skill MCP Rules (thin — policy source of truth: `skills/horosa-agent/SKILL.md`)

- - Any Horosa / 星阙 metaphysics output → call the Horosa MCP tools (`horosa_cn_qimen`,

- `horosa_cn_liureng_gods`, `horosa_astro_chart`, …). **Never hand-calculate** with Exec/Python/JS/web

- formulas — they bypass the runtime, Xingque defaults, export contract, memory, and reports.

+ - Any Horosa / 星阙 metaphysics output → call the Horosa MCP tools. Cursor gets the **compact surface** by

+ default (11 facades): call techniques by name via `horosa_tool_run(tool_name="qimen", …)`; the flat

+ `horosa_cn_qimen` / `horosa_astro_chart` names only exist with `--surface full`, and the catalogue is the

+ `horosa://catalog/techniques` resource. **Never hand-calculate** with Exec/Python/JS/web formulas — they

+ bypass the runtime, Xingque defaults, export contract, memory, and reports.

+ - No `horosa` tools in the list? `horosa-skill setup --client cursor` (`uv run horosa-skill setup --client cursor`

+ inside this checkout) registers everything; `horosa-skill doctor` is the health report.

- **Clarify before calling**: if a result-changing setting is missing (time/place/timezone, gender,

house system, 起局方式, 贵人体系, 六爻 lines, 地分, target year/date, report format), ask a short

question with options first — or call `horosa_agent_guidance`. Defaults only when the user

explicitly accepts them (大六壬 default `guirengType: 2` 星占法贵人).

- Gate protocol: tools reject unconfirmed calls with `agent_guidance.required`; after the user

answers include `agent_confirmed_settings: true` (`defaults_accepted: true` for accepted defaults)

+ `clarification_notes`. On `details.agent_recovery` → stop and ask with `prompt_to_user`; never

self-confirm or switch tools to bypass.

- Trust only the returned `export_snapshot.export_text` / `export_format.sections`. Missing section →

rerun `doctor` / `openclaw-check`; never claim MongoDB / port 7897 / Xingque Desktop / remote-DB

dependencies.

- Full client policy + payload/report/troubleshooting sheets: `skills/horosa-agent/SKILL.md`

(+ its `references/`). Repo/maintainer rules: `AGENTS.md`.