# 总助 Claw / Atlas 🦅 > **老板视角项目执行雷达**——把散落在邮件 / 微信 / 飞书里的工作安排，自动织成一张"人 × 项目 × 客户"三维盘子，每天告诉老板：谁在跟、跟得怎样、有没有卡点、有没有不了了之的事、哪些客户要亲自出面。 > "把太多不了了之的事，重新装回老板的视野里。" --- ## 📍 想做什么 → 看哪里 | 目标 | 路径 | |------|------| | 快速安装配置 | [`QUICKSTART.zh-CN.md`](./QUICKSTART.zh-CN.md) | | 看是个什么产品（5 分钟读完） | [`AGENTS.md`](./AGENTS.md) + [`SOUL.md`](./SOUL.md) | | 给客户讲（2 页文档） | [`client-deck/`](./client-deck/) | | 看 6 个 sub-skill | [`skills/`](./skills/) | | 看 boss_skill 蒸馏 demo（10 封邮件 → 5 层老板 OS） | [`skills/claw-boss-distiller/demo/`](./skills/claw-boss-distiller/demo/) | | 跑邮件抽取（Python 实现，pytest 通过） | [`mcp-tools/email-extractor/`](./mcp-tools/email-extractor/) | | 装到 Hermes Agent 上跑 | [`INTEGRATION-hermes.md`](./INTEGRATION-hermes.md) | | 项目卡 / 人员卡 / 客户卡 JSON schema | [`state-schemas/`](./state-schemas/) | | Autopilot 定义（5 个：daily / weekly / monthly / quarterly + andon） | [`autopilots/`](./autopilots/) | | 设计决策记录 | [`docs/decisions/`](./docs/decisions/) | --- ## 🚀 快速启动 ### 浏览设计 ```bash git clone https://git.moments.top/Moments.top/assistant-claw.git cd assistant-claw cat AGENTS.md # 入口模式 + skill 名册 + autopilot 排班 cat SOUL.md # 边界：永不评级员工 / 永不替老板写信 / 永带引用 open client-deck/ # 客户演示 ``` ### 跑邮件抽取（本地，无需任何外部凭据） ```bash cd 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 \ 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 \ skills/claw-boss-distiller/upstream ``` ### 接到 Hermes Agent 跑 详见 [`INTEGRATION-hermes.md`](./INTEGRATION-hermes.md)。一句话：6 个 SKILL.md 已经按 agentskills.io / Hermes 兼容格式写好，`cp -r skills/* ~/.hermes/skills/atlas/` 即可被识别。 --- ## 📐 仓库结构 ``` assistant-claw/ ← 本仓库 = 总助 Claw / Atlas │ ├── README.md 本文件 ├── .gitignore │ ├── 🆔 OpenClaw 8 件套（agent 身份层，根目录直接读） │ ├── IDENTITY.md / .zh-CN.md 🦅 Atlas 身份卡：老板视角项目执行雷达 │ ├── SOUL.md / .zh-CN.md 边界与原则 │ ├── USER.md 谁是 user（老板，按客户实例化） │ ├── AGENTS.md / .zh-CN.md 入口模式 / skill 名册 / 工具 / autopilot 排班 │ ├── TOOLS.md 工具配置（IMAP/Gmail/Exchange + 报告渲染） │ ├── MEMORY.md 长期记忆模板 │ ├── BOOTSTRAP.md 首次部署 7 步清单 │ ├── HEARTBEAT.md 每日 / 周 / 月 / 季 + 事件触发任务表 │ └── CLAUDE.md → AGENTS.md 软链 │ ├── 📚 INTEGRATION-hermes.md Hermes Agent 集成 SOP（30 min） │ ├── 🛠️ skills/ 6 个 Atlas sub-skill │ ├── DESCRIPTION.md Hermes category 描述 │ ├── README.md skill 协作流图 │ ├── claw-email-parser/SKILL.md 邮件抽取入口 │ ├── claw-project-tracker/SKILL.md 项目状态判定（GTD/RACI） │ ├── claw-people-observer/SKILL.md 人员观察（硬约束：永不打员工等级） │ ├── claw-customer-radar/SKILL.md 客户健康度（CHS + Andon） │ ├── claw-boss-distiller/ ⭐ nuwa-skill 衍生 │ │ ├── SKILL.md │ │ ├── ADAPTER.md nuwa→Atlas 改造说明 │ │ ├── boss_skill.seed.md 23 条种子规则跨 5 层 │ │ ├── upstream/README.md 部署时 git clone nuwa 的 SOP │ │ └── demo/ 完整蒸馏 demo（10 邮件 → 5 层） │ └── claw-report-writer/SKILL.md 日 / 周 / 月报渲染 │ ├── 🔌 mcp-tools/ 工具层 │ ├── README.md 工具清单 + 授权矩阵 │ ├── email-extractor.md 7 阶段抽取流水线 spec │ └── email-extractor/ Python V0 实现（pytest 7/7 通过） │ ├── atlas_extractor/ fetch + decode + dequote + pipeline + cli │ ├── tests/ fixture + test_dequote │ └── pyproject.toml → 安装后得到 atlas-extract CLI │ ├── 📦 state-schemas/ 三张卡的正式 JSON schema │ ├── README.md │ ├── project.md │ ├── person.md │ └── customer.md │ ├── ⏰ autopilots/ 5 个 Multica autopilot 配置 │ ├── atlas-daily-brief.yaml cron 30 7 * * * │ ├── atlas-weekly-rollup.yaml cron 0 8 * * 1 │ ├── atlas-monthly-customer-health.yaml cron 0 9 1 * * │ ├── atlas-quarterly-boss-skill-refresh.yaml cron 0 10 1 1,4,7,10 * │ └── atlas-andon-event.yaml event_triggered（非定时） │ ├── 🎤 client-deck/ 给客户的演示主材料 │ ├── 📝 docs/ │ └── decisions/ ADR │ └── 0001-mirror-nuwa-skill.md │ └── 🔧 scripts/ └── mirror-nuwa-to-moments.sh 一键镜像 nuwa-skill 到 Moments Gitea ``` --- ## 🎯 产品定位 | 维度 | Atlas | |------|-------| | **服务对象** | 企业一把手（董事长 / 总经理 / 创始人）一人 | | **核心痛点** | 太多事情不了了之 | | **数据源** | 邮件（V0）→ 微信（V0.5）→ 飞书（V1） | | **学习成本** | 0（老板照常发邮件，AI 在后台读） | | **首份交付** | W1 末："过去一年项目盘点 + 落地率诊断"报告 | | **日常节奏** | 每天 7:30 一封 5 分钟看完的 Brief | | **北极星指标** | 老板看完 Brief 能立刻说出今日 3 件事 | | **部署模型** | 100% 客户私有部署，每客户一个独立实例 | 引用 10 套主流管理框架（GTD / RACI / Andy Grove / 9-Box / BARS / CCAR / ONA / CHS / VoC / WBR），每条 AI 判定都标依据规则号，老板 override 一行邮件就生效。 --- ## ⚙️ 工作约定 - **Issue / 任务流转走 Multica**：所有给 Atlas 的需求、反馈、复盘走 Multica 的 issue + comment，不在仓库里开 issue - **改动走 PR**：根目录文件、`skills/`、`mcp-tools/`、`autopilots/`、`state-schemas/` 下的内容都进 production，必须 PR + review - **每客户实例隔离**：每个客户的 `state/`（projects/people/customers/runs/audit）永远在客户机器上，不进本仓库 - **保持 lean**：宁可少加，也不堆没人用的脚手架 - **永不放宽硬边界**：SOUL.md + 各 SKILL.md `boundaries:` 字段是死线（不评级员工 / 不写邮件给非老板 / 跨客户隔离 / 不编造证据） --- ## 🔗 相关 - **Multica project**：总助 Claw（`fdc928a7-d204-4a9f-929e-2c59bea9cda3`） - **上游开源依赖**： - [`alchaincyf/nuwa-skill`](https://github.com/alchaincyf/nuwa-skill)（MIT）—— 心智蒸馏方法论 - [`NousResearch/hermes-agent`](https://github.com/NousResearch/hermes-agent)（MIT）—— 推荐运行时 - **agentskills.io 标准**：https://agentskills.io - **Mirror（air-gapped 客户部署用）**：`https://git.moments.top/Moments.top/nuwa-skill`（待建） --- ## 🗺️ 路线图 ### 已完成 - [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 - [x] state schemas（project / person / customer） - [x] 5 个 autopilot YAML ### 待办 - [ ] **nuwa-skill 镜像到 Moments Gitea**（仓库已建则 `bash scripts/mirror-nuwa-to-moments.sh`） - [ ] email-extractor Stage 4-7（threading / entities / intent / canonical 输出） - [ ] 6 个 sub-skill 的可执行实现（当前是设计文档） - [ ] `atlas-extractor` 包成 MCP server - [ ] dogfood：装到内部 Hermes 实例端到端跑一次 - [ ] 第一个客户 W1 部署