193 lines
8.8 KiB
Markdown
193 lines
8.8 KiB
Markdown
# 总助 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 部署
|