assistant-claw/README.md

assistant-claw（总助Claw）

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

assistant-claw 是 Moments / 莫曼茨智能科技的总助 Claw 配置中心，一个仓库装两个 agent profile：

Profile	角色	状态	入口
Atlas 🦅	老板视角项目执行雷达——按客户部署的纵向产品	设计 + 邮件抽取实现 + 蒸馏 demo 完成	atlas/
Vega ⭐	通用助理 agent——莫曼茨内部多面手	骨架占位	prompts/ skills/ tools/

两个 profile 共用本仓库的目录约定（prompts / skills / tools / autopilots / docs），Atlas 资产隔离在 atlas/ 子目录，避免污染 Vega 的演进路径。

---

📍 想做什么 → 看哪里

目标	路径
看 Atlas 是个什么产品	atlas/README.md
给客户讲 Atlas（2 页文档）	atlas/client-deck/总助Claw_客户演示_v1.md
看 Atlas 的 6 个 sub-skill	atlas/skills/
看 boss_skill 蒸馏 demo（10 封邮件 → 5 层老板 OS）	atlas/skills/claw-boss-distiller/demo/
跑邮件抽取（Python 实现，pytest 通过）	atlas/mcp-tools/email-extractor/
把 Atlas 装到 Hermes Agent 上跑	atlas/INTEGRATION-hermes.md
项目卡 / 人员卡 / 客户卡 JSON schema	atlas/state-schemas/
自动化任务定义（cron + 事件）	autopilots/atlas-*.yaml
设计决策记录	docs/decisions/
Vega 配置（待填）	prompts/ skills/ tools/

---

🚀 快速启动 — Atlas

浏览设计

git clone https://git.moments.top/Moments.top/assistant-claw.git
cd assistant-claw/atlas
cat README.md          # 总览
open client-deck/      # 客户演示

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

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

# 公网部署
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。一句话：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 和 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（MIT）—— Atlas 心智蒸馏方法论的来源
  • NousResearch/hermes-agent（MIT）—— 推荐运行时
• agentskills.io 标准：https://agentskills.io
• Atlas 北极星：老板每天 5 分钟看完日 Brief，能立刻说出今日 3 件事

---

🗺️ 路线图

Atlas

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