# assistant-claw（总助Claw） > "把太多不了了之的事，重新装回老板的视野里。" `assistant-claw` 是 Moments / 莫曼茨智能科技的**总助 Claw 配置中心**，一个仓库装两个 agent profile： | Profile | 角色 | 状态 | 入口 | |---------|------|------|------| | **Atlas** 🦅 | 老板视角项目执行雷达——按客户部署的纵向产品 | 设计 + 邮件抽取实现 + 蒸馏 demo 完成 | [`atlas/`](./atlas/) | | **Vega** ⭐ | 通用助理 agent——莫曼茨内部多面手 | 骨架占位 | [`prompts/`](./prompts/) `skills/` `tools/` | 两个 profile 共用本仓库的目录约定（prompts / skills / tools / autopilots / docs），**Atlas 资产隔离在 `atlas/` 子目录**，避免污染 Vega 的演进路径。 --- ## 📍 想做什么 → 看哪里 | 目标 | 路径 | |------|------| | 看 Atlas 是个什么产品 | [`atlas/README.md`](./atlas/README.md) | | 给客户讲 Atlas（2 页文档） | [`atlas/client-deck/总助Claw_客户演示_v1.md`](./atlas/client-deck/) | | 看 Atlas 的 6 个 sub-skill | [`atlas/skills/`](./atlas/skills/) | | 看 boss_skill 蒸馏 demo（10 封邮件 → 5 层老板 OS） | [`atlas/skills/claw-boss-distiller/demo/`](./atlas/skills/claw-boss-distiller/demo/) | | 跑邮件抽取（Python 实现，pytest 通过） | [`atlas/mcp-tools/email-extractor/`](./atlas/mcp-tools/email-extractor/) | | 把 Atlas 装到 Hermes Agent 上跑 | [`atlas/INTEGRATION-hermes.md`](./atlas/INTEGRATION-hermes.md) | | 项目卡 / 人员卡 / 客户卡 JSON schema | [`atlas/state-schemas/`](./atlas/state-schemas/) | | 自动化任务定义（cron + 事件） | [`autopilots/atlas-*.yaml`](./autopilots/) | | 设计决策记录 | [`docs/decisions/`](./docs/decisions/) | | Vega 配置（待填） | [`prompts/`](./prompts/) `skills/` `tools/` | --- ## 🚀 快速启动 — Atlas ### 浏览设计 ```bash git clone https://git.moments.top/Moments.top/assistant-claw.git cd assistant-claw/atlas cat README.md # 总览 open client-deck/ # 客户演示 ``` ### 跑邮件抽取（本地，无需任何外部凭据） ```bash cd assistant-claw/atlas/mcp-tools/email-extractor python -m venv .venv && .venv/bin/pip install -e '.[test]' .venv/bin/pytest -q # 7/7 测试通过 .venv/bin/atlas-extract dir \ --input-dir ../../skills/claw-boss-distiller/demo/INPUT \ --state-dir /tmp/atlas-test ``` ### 拉 nuwa-skill 上游（claw-boss-distiller 依赖） ```bash # 公网部署 git clone --depth 1 https://github.com/alchaincyf/nuwa-skill.git \ atlas/skills/claw-boss-distiller/upstream # 客户内网（air-gapped）部署 —— 用 Moments 私有 Gitea 镜像 # （镜像建立流程见 docs/decisions/0001-mirror-nuwa-skill.md） git clone --depth 1 https://git.moments.top/Moments.top/nuwa-skill.git \ atlas/skills/claw-boss-distiller/upstream ``` ### 接到 Hermes Agent 跑 详见 [`atlas/INTEGRATION-hermes.md`](./atlas/INTEGRATION-hermes.md)。一句话：6 个 SKILL.md 已经按 agentskills.io / Hermes 兼容格式写好，直接 `cp -r atlas/skills/* ~/.hermes/skills/atlas/`。 --- ## 📐 仓库目录约定 ``` assistant-claw/ ├── README.md ← 本文件 ├── .gitignore │ ├── prompts/ Vega system prompt + 人格（占位，待填） ├── skills/ Vega 通用 skill（占位） ├── tools/ Vega 调用的 MCP / 自定义脚本（占位） ├── docs/ │ └── decisions/ ADR — 架构决策记录 │ └── 0001-mirror-nuwa-skill.md │ ├── autopilots/ Multica autopilot 配置（YAML，多 profile 共用） │ ├── atlas-daily-brief.yaml │ ├── atlas-weekly-rollup.yaml │ ├── atlas-monthly-customer-health.yaml │ ├── atlas-quarterly-boss-skill-refresh.yaml │ └── atlas-andon-event.yaml │ ├── scripts/ 一次性运维脚本 │ └── mirror-nuwa-to-moments.sh （nuwa-skill 镜像到 Moments Gitea） │ └── atlas/ 🦅 Atlas profile 全部资产 ├── README.md ├── INTEGRATION-hermes.md Hermes Agent 集成 SOP ├── IDENTITY.md SOUL.md USER.md AGENTS.md TOOLS.md MEMORY.md │ BOOTSTRAP.md HEARTBEAT.md (+ .zh-CN.md 镜像) ├── CLAUDE.md → AGENTS.md 软链 ├── client-deck/ 客户演示主材料 ├── mcp-tools/ │ ├── email-extractor.md 设计 spec（7 阶段流水线） │ └── email-extractor/ Python V0 实现（fetch + decode + dequote） ├── skills/ │ ├── DESCRIPTION.md Hermes category 描述 │ ├── claw-email-parser/SKILL.md │ ├── claw-project-tracker/SKILL.md │ ├── claw-people-observer/SKILL.md 硬约束：永不打员工等级 │ ├── claw-customer-radar/SKILL.md CHS + Andon │ ├── claw-boss-distiller/ ⭐ nuwa-skill 衍生 │ │ ├── SKILL.md ADAPTER.md boss_skill.seed.md │ │ ├── upstream/README.md 部署时拉取的 SOP │ │ └── demo/ 完整蒸馏 demo │ └── claw-report-writer/SKILL.md └── state-schemas/ 项目 / 人员 / 客户 三张卡 JSON schema ``` ### 内容约定 #### `prompts/` — system prompt + 人格 单一可信源。线上 agent 的 prompt 应该从这里发布，不直接在 Multica 后台手动编辑。 #### `skills/` 每个 skill 一个子目录，至少包含 `SKILL.md`，frontmatter 必须有： - `name` — 唯一短名（kebab-case） - `description` — 一行触发说明 - 可选增强字段（推荐）：`version`、`author`、`license`、`metadata.hermes.{tags, category, related_skills, boundaries}` —— 这些让 skill 兼容 [agentskills.io](https://agentskills.io) 和 Hermes Agent #### `tools/` - `tools/mcp/` — MCP server 配置 - `tools/scripts/` — Vega 通过 Bash 调用的自定义脚本 #### `autopilots/` 对应 `multica autopilot create` 的配置文件，一个 autopilot 一个 YAML： - `title`、`description`、`agent`、`mode` - `schedule`（cron 或事件触发） - `payload` / `delivery` - `guardrails` 发布时通过脚本读这些文件批量调 `multica autopilot create/update`，避免漂移。 #### `docs/decisions/` — ADR 改动 prompts / skills / tools 之前先写一段 ADR，比事后追溯便宜。 --- ## ⚙️ 工作约定 - **Issue / 任务流转走 Multica**：所有给 agent 的任务、反馈、复盘走 Multica 的 issue + comment，**不在仓库里开 issue** - **改动走 PR**：`prompts/`、`skills/`、`tools/`、`autopilots/`、`atlas/` 下的内容都进 production，必须 PR + review，不直接 push main - **Atlas profile 是按客户实例化部署的**：每个客户的 `state/` 永远在客户机器上，不进本仓库 - **保持 lean**：宁可少加，也不堆没人用的脚手架 --- ## 🔗 相关 - **Multica project**：总助 Claw（`fdc928a7-d204-4a9f-929e-2c59bea9cda3`） - **兄弟仓库**：`research-claw` / `trainer-claw` / `geo-claw` - **上游开源依赖**： - [`alchaincyf/nuwa-skill`](https://github.com/alchaincyf/nuwa-skill)（MIT）—— Atlas 心智蒸馏方法论的来源 - [`NousResearch/hermes-agent`](https://github.com/NousResearch/hermes-agent)（MIT）—— 推荐运行时 - **agentskills.io 标准**：https://agentskills.io - **Atlas 北极星**：老板每天 5 分钟看完日 Brief，能立刻说出今日 3 件事 --- ## 🗺️ 路线图 ### Atlas - [x] OpenClaw 8 件套 + 6 sub-skill 设计 - [x] email-extractor V0（Stage 1-3 实现 + 7 测试通过） - [x] boss-distiller demo run（10 封邮件 → 5 层蒸馏验证） - [x] 客户演示 deck v1 - [x] Hermes 集成 SOP - [ ] **nuwa-skill 镜像到 Moments Gitea**（仓库已建则一键 `scripts/mirror-nuwa-to-moments.sh`） - [ ] email-extractor Stage 4-7（threading / entities / intent / canonical） - [ ] 6 个 sub-skill 的可执行实现（当前是设计文档） - [ ] `atlas-extractor` 包成 MCP server - [ ] 第一个客户 W1 部署 ### Vega - [ ] system prompt 落到 `prompts/system.md` - [ ] 抽出最常用的 3–5 个通用 skill - [ ] 把现有 autopilot 反向导出到 `autopilots/` - [ ] CI：对 `prompts/` 和 `skills/` 做 schema / lint 校验