04e197c896
Three things in this commit:
1. Atlas skills now agentskills.io / Hermes-compatible
- Each atlas/skills/claw-*/SKILL.md frontmatter enriched with version,
author, license, and metadata.hermes block (tags, category,
related_skills, boundaries)
- New atlas/skills/DESCRIPTION.md per Hermes category convention
- New atlas/INTEGRATION-hermes.md — step-by-step SOP to install Atlas
onto hermes-agent runtime (cp skills, fetch nuwa upstream, configure
env, wire cron, smoke test). Documents the branding override and
self-improving-loop guardrail.
2. nuwa-skill mirror prep (waiting on org-repo creation)
- scripts/mirror-nuwa-to-moments.sh — one-shot bare-clone + push --mirror
- docs/decisions/0001-mirror-nuwa-skill.md — ADR explaining the why,
the bot-token scope limitation, and the manual one-time repo creation
step required at https://git.moments.top/repo/create
3. README rewrite
- Atlas-forward navigation table ("想做什么 → 看哪里")
- Quickstart sections for browsing, running tests locally, fetching
nuwa upstream (public + air-gapped variants), and Hermes integration
- Preserved all original Vega working agreements
- Roadmap with explicit Atlas / Vega tracks
Bot account (multica-bot) lacks write:organization scope so cannot create
the nuwa-skill repo via API. After human creates the empty repo at
git.moments.top/Moments.top/nuwa-skill, run scripts/mirror-nuwa-to-moments.sh
to populate it.
191 lines
8.4 KiB
Markdown
191 lines
8.4 KiB
Markdown
# 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 校验
|