总助 Claw / Atlas 🦅

老板视角项目执行雷达——把散落在邮件 / 微信 / 飞书里的工作安排，自动织成一张"人 × 项目 × 客户"三维盘子，每天告诉老板：谁在跟、跟得怎样、有没有卡点、有没有不了了之的事、哪些客户要亲自出面。

"把太多不了了之的事，重新装回老板的视野里。"

---

📍 想做什么 → 看哪里

目标	路径
看是个什么产品（5 分钟读完）	AGENTS.md + SOUL.md
给客户讲（2 页文档）	client-deck/
看 6 个 sub-skill	skills/
看 boss_skill 蒸馏 demo（10 封邮件 → 5 层老板 OS）	skills/claw-boss-distiller/demo/
跑邮件抽取（Python 实现，pytest 通过）	mcp-tools/email-extractor/
装到 Hermes Agent 上跑	INTEGRATION-hermes.md
项目卡 / 人员卡 / 客户卡 JSON schema	state-schemas/
Autopilot 定义（5 个：daily / weekly / monthly / quarterly + andon）	autopilots/
设计决策记录	docs/decisions/

---

🚀 快速启动

浏览设计

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/        # 客户演示

跑邮件抽取（本地，无需任何外部凭据）

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 依赖）

# 公网部署
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。一句话：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（MIT）—— 心智蒸馏方法论
  • NousResearch/hermes-agent（MIT）—— 推荐运行时
• agentskills.io 标准：https://agentskills.io
• Mirror（air-gapped 客户部署用）：https://git.moments.top/Moments.top/nuwa-skill（待建）

---

🗺️ 路线图

已完成

• OpenClaw 8 件套 + 6 sub-skill 设计
• email-extractor V0（Stage 1-3 实现 + 7 测试通过）
• boss-distiller demo run（10 封邮件 → 5 层蒸馏验证）
• 客户演示 deck v1
• Hermes 集成 SOP
• state schemas（project / person / customer）
• 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 部署