Refactor: drop Vega framing, promote Atlas to repo root
This repo IS Atlas (总助 Claw / 老板视角项目执行雷达). The earlier
two-profile framing (Atlas + Vega placeholder) was a misread — Vega is
the agent persona answering Multica issues, not the product. Vega has
no relationship to assistant-claw the product.
Changes:
- Move atlas/* to top-level (git mv preserves history)
- Remove empty Vega placeholders prompts/.gitkeep, tools/.gitkeep
- Delete atlas/ wrapper directory (now empty)
- Update path references in INTEGRATION-hermes.md, scripts/mirror-...sh,
docs/decisions/0001-mirror-nuwa-skill.md
- Rewrite README.md as Atlas-only, remove dual-profile language
After this commit:
- Top-level OpenClaw 8 files (IDENTITY/SOUL/USER/AGENTS/TOOLS/MEMORY/
BOOTSTRAP/HEARTBEAT + CLAUDE symlink + zh-CN mirrors)
- skills/{6 sub-skills + DESCRIPTION + README}
- mcp-tools/{spec + Python implementation}
- state-schemas/{project, person, customer + README}
- autopilots/{5 atlas-*.yaml}
- client-deck/, docs/decisions/, scripts/
The ~/.hermes/skills/atlas/ destination convention preserved (atlas as
a skill namespace on the operator's machine, distinct from source path).
This commit is contained in:
parent
04e197c896
commit
bd0be97630
@ -19,7 +19,7 @@ This doc tells the operator how to install Atlas on top of Hermes in ≤ 30 minu
|
|||||||
```bash
|
```bash
|
||||||
# Hermes scans ~/.hermes/skills/ on startup
|
# Hermes scans ~/.hermes/skills/ on startup
|
||||||
mkdir -p ~/.hermes/skills/atlas
|
mkdir -p ~/.hermes/skills/atlas
|
||||||
cp -r atlas/skills/* ~/.hermes/skills/atlas/
|
cp -r skills/* ~/.hermes/skills/atlas/
|
||||||
|
|
||||||
# Check Hermes sees them
|
# Check Hermes sees them
|
||||||
hermes skills list | grep claw-
|
hermes skills list | grep claw-
|
||||||
@ -43,12 +43,12 @@ git clone --depth 1 https://git.moments.top/Moments.top/nuwa-skill.git \
|
|||||||
|
|
||||||
## Step 3 — Install atlas-extractor as an MCP server (TBD code)
|
## Step 3 — Install atlas-extractor as an MCP server (TBD code)
|
||||||
|
|
||||||
The `atlas/mcp-tools/email-extractor/` Python package currently exposes a CLI
|
The `mcp-tools/email-extractor/` Python package currently exposes a CLI
|
||||||
(`atlas-extract`). Wrapping it as an MCP server is V0.5 work; until then
|
(`atlas-extract`). Wrapping it as an MCP server is V0.5 work; until then
|
||||||
Hermes can call the CLI via Bash.
|
Hermes can call the CLI via Bash.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd atlas/mcp-tools/email-extractor
|
cd mcp-tools/email-extractor
|
||||||
python -m venv .venv
|
python -m venv .venv
|
||||||
.venv/bin/pip install -e '.[test]'
|
.venv/bin/pip install -e '.[test]'
|
||||||
.venv/bin/pytest -q # confirm 7/7 passing
|
.venv/bin/pytest -q # confirm 7/7 passing
|
||||||
@ -66,7 +66,7 @@ hermes env set ATLAS_STATE_DIR ~/.atlas/state
|
|||||||
|
|
||||||
## Step 5 — Wire the autopilots into Hermes cron
|
## Step 5 — Wire the autopilots into Hermes cron
|
||||||
|
|
||||||
Atlas's 5 autopilot YAMLs live in `../autopilots/atlas-*.yaml`. Translate each
|
Atlas's 5 autopilot YAMLs live in `autopilots/atlas-*.yaml`. Translate each
|
||||||
into Hermes natural-language cron:
|
into Hermes natural-language cron:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@ -83,12 +83,12 @@ sentinel file like `~/.atlas/state/runs/_andon_pending.flag`.
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Manually invoke claw-boss-distiller on the demo input
|
# Manually invoke claw-boss-distiller on the demo input
|
||||||
hermes "Run claw-boss-distiller on atlas/skills/claw-boss-distiller/demo/INPUT/ \
|
hermes "Run claw-boss-distiller on skills/claw-boss-distiller/demo/INPUT/ \
|
||||||
and write the result to atlas/skills/claw-boss-distiller/demo/OUTPUT/boss_skill.live.md"
|
and write the result to skills/claw-boss-distiller/demo/OUTPUT/boss_skill.live.md"
|
||||||
|
|
||||||
# Check it produced a 5-layer doc
|
# Check it produced a 5-layer doc
|
||||||
diff atlas/skills/claw-boss-distiller/demo/OUTPUT/boss_skill.demo.md \
|
diff skills/claw-boss-distiller/demo/OUTPUT/boss_skill.demo.md \
|
||||||
atlas/skills/claw-boss-distiller/demo/OUTPUT/boss_skill.live.md
|
skills/claw-boss-distiller/demo/OUTPUT/boss_skill.live.md
|
||||||
```
|
```
|
||||||
|
|
||||||
## Step 7 — First Daily Brief
|
## Step 7 — First Daily Brief
|
||||||
@ -118,5 +118,5 @@ The boss receives a 5-minute Brief in their inbox.
|
|||||||
## Roadmap
|
## Roadmap
|
||||||
|
|
||||||
- [ ] V0.5: Wrap `atlas-extractor` as proper MCP server (replace Bash CLI invocation)
|
- [ ] V0.5: Wrap `atlas-extractor` as proper MCP server (replace Bash CLI invocation)
|
||||||
- [ ] V0.5: Auto-generate Hermes skill manifest from `atlas/skills/*/SKILL.md` on commit
|
- [ ] V0.5: Auto-generate Hermes skill manifest from `skills/*/SKILL.md` on commit
|
||||||
- [ ] V1: Build a Hermes "skill pack" installer (`hermes skills install moments/atlas`)
|
- [ ] V1: Build a Hermes "skill pack" installer (`hermes skills install moments/atlas`)
|
||||||
213
README.md
213
README.md
@ -1,50 +1,43 @@
|
|||||||
# assistant-claw(总助Claw)
|
# 总助 Claw / Atlas 🦅
|
||||||
|
|
||||||
|
> **老板视角项目执行雷达**——把散落在邮件 / 微信 / 飞书里的工作安排,自动织成一张"人 × 项目 × 客户"三维盘子,每天告诉老板:谁在跟、跟得怎样、有没有卡点、有没有不了了之的事、哪些客户要亲自出面。
|
||||||
|
|
||||||
> "把太多不了了之的事,重新装回老板的视野里。"
|
> "把太多不了了之的事,重新装回老板的视野里。"
|
||||||
|
|
||||||
`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) |
|
| 看是个什么产品(5 分钟读完) | [`AGENTS.md`](./AGENTS.md) + [`SOUL.md`](./SOUL.md) |
|
||||||
| 给客户讲 Atlas(2 页文档) | [`atlas/client-deck/总助Claw_客户演示_v1.md`](./atlas/client-deck/) |
|
| 给客户讲(2 页文档) | [`client-deck/`](./client-deck/) |
|
||||||
| 看 Atlas 的 6 个 sub-skill | [`atlas/skills/`](./atlas/skills/) |
|
| 看 6 个 sub-skill | [`skills/`](./skills/) |
|
||||||
| 看 boss_skill 蒸馏 demo(10 封邮件 → 5 层老板 OS) | [`atlas/skills/claw-boss-distiller/demo/`](./atlas/skills/claw-boss-distiller/demo/) |
|
| 看 boss_skill 蒸馏 demo(10 封邮件 → 5 层老板 OS) | [`skills/claw-boss-distiller/demo/`](./skills/claw-boss-distiller/demo/) |
|
||||||
| 跑邮件抽取(Python 实现,pytest 通过) | [`atlas/mcp-tools/email-extractor/`](./atlas/mcp-tools/email-extractor/) |
|
| 跑邮件抽取(Python 实现,pytest 通过) | [`mcp-tools/email-extractor/`](./mcp-tools/email-extractor/) |
|
||||||
| 把 Atlas 装到 Hermes Agent 上跑 | [`atlas/INTEGRATION-hermes.md`](./atlas/INTEGRATION-hermes.md) |
|
| 装到 Hermes Agent 上跑 | [`INTEGRATION-hermes.md`](./INTEGRATION-hermes.md) |
|
||||||
| 项目卡 / 人员卡 / 客户卡 JSON schema | [`atlas/state-schemas/`](./atlas/state-schemas/) |
|
| 项目卡 / 人员卡 / 客户卡 JSON schema | [`state-schemas/`](./state-schemas/) |
|
||||||
| 自动化任务定义(cron + 事件) | [`autopilots/atlas-*.yaml`](./autopilots/) |
|
| Autopilot 定义(5 个:daily / weekly / monthly / quarterly + andon) | [`autopilots/`](./autopilots/) |
|
||||||
| 设计决策记录 | [`docs/decisions/`](./docs/decisions/) |
|
| 设计决策记录 | [`docs/decisions/`](./docs/decisions/) |
|
||||||
| Vega 配置(待填) | [`prompts/`](./prompts/) `skills/` `tools/` |
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🚀 快速启动 — Atlas
|
## 🚀 快速启动
|
||||||
|
|
||||||
### 浏览设计
|
### 浏览设计
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://git.moments.top/Moments.top/assistant-claw.git
|
git clone https://git.moments.top/Moments.top/assistant-claw.git
|
||||||
cd assistant-claw/atlas
|
cd assistant-claw
|
||||||
cat README.md # 总览
|
cat AGENTS.md # 入口模式 + skill 名册 + autopilot 排班
|
||||||
open client-deck/ # 客户演示
|
cat SOUL.md # 边界:永不评级员工 / 永不替老板写信 / 永带引用
|
||||||
|
open client-deck/ # 客户演示
|
||||||
```
|
```
|
||||||
|
|
||||||
### 跑邮件抽取(本地,无需任何外部凭据)
|
### 跑邮件抽取(本地,无需任何外部凭据)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd assistant-claw/atlas/mcp-tools/email-extractor
|
cd mcp-tools/email-extractor
|
||||||
python -m venv .venv && .venv/bin/pip install -e '.[test]'
|
python -m venv .venv && .venv/bin/pip install -e '.[test]'
|
||||||
.venv/bin/pytest -q # 7/7 测试通过
|
.venv/bin/pytest -q # 7/7 测试通过
|
||||||
.venv/bin/atlas-extract dir \
|
.venv/bin/atlas-extract dir \
|
||||||
@ -57,134 +50,142 @@ python -m venv .venv && .venv/bin/pip install -e '.[test]'
|
|||||||
```bash
|
```bash
|
||||||
# 公网部署
|
# 公网部署
|
||||||
git clone --depth 1 https://github.com/alchaincyf/nuwa-skill.git \
|
git clone --depth 1 https://github.com/alchaincyf/nuwa-skill.git \
|
||||||
atlas/skills/claw-boss-distiller/upstream
|
skills/claw-boss-distiller/upstream
|
||||||
|
|
||||||
# 客户内网(air-gapped)部署 —— 用 Moments 私有 Gitea 镜像
|
# 客户内网(air-gapped)部署 —— 用 Moments 私有 Gitea 镜像
|
||||||
# (镜像建立流程见 docs/decisions/0001-mirror-nuwa-skill.md)
|
# 镜像建立流程见 docs/decisions/0001-mirror-nuwa-skill.md
|
||||||
git clone --depth 1 https://git.moments.top/Moments.top/nuwa-skill.git \
|
git clone --depth 1 https://git.moments.top/Moments.top/nuwa-skill.git \
|
||||||
atlas/skills/claw-boss-distiller/upstream
|
skills/claw-boss-distiller/upstream
|
||||||
```
|
```
|
||||||
|
|
||||||
### 接到 Hermes Agent 跑
|
### 接到 Hermes Agent 跑
|
||||||
|
|
||||||
详见 [`atlas/INTEGRATION-hermes.md`](./atlas/INTEGRATION-hermes.md)。一句话:6 个 SKILL.md 已经按 agentskills.io / Hermes 兼容格式写好,直接 `cp -r atlas/skills/* ~/.hermes/skills/atlas/`。
|
详见 [`INTEGRATION-hermes.md`](./INTEGRATION-hermes.md)。一句话:6 个 SKILL.md 已经按 agentskills.io / Hermes 兼容格式写好,`cp -r skills/* ~/.hermes/skills/atlas/` 即可被识别。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📐 仓库目录约定
|
## 📐 仓库结构
|
||||||
|
|
||||||
```
|
```
|
||||||
assistant-claw/
|
assistant-claw/ ← 本仓库 = 总助 Claw / Atlas
|
||||||
├── README.md ← 本文件
|
│
|
||||||
|
├── README.md 本文件
|
||||||
├── .gitignore
|
├── .gitignore
|
||||||
│
|
│
|
||||||
├── prompts/ Vega system prompt + 人格(占位,待填)
|
├── 🆔 OpenClaw 8 件套(agent 身份层,根目录直接读)
|
||||||
├── skills/ Vega 通用 skill(占位)
|
│ ├── IDENTITY.md / .zh-CN.md 🦅 Atlas 身份卡:老板视角项目执行雷达
|
||||||
├── tools/ Vega 调用的 MCP / 自定义脚本(占位)
|
│ ├── SOUL.md / .zh-CN.md 边界与原则
|
||||||
├── docs/
|
│ ├── USER.md 谁是 user(老板,按客户实例化)
|
||||||
│ └── decisions/ ADR — 架构决策记录
|
│ ├── 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
|
│ └── 0001-mirror-nuwa-skill.md
|
||||||
│
|
│
|
||||||
├── autopilots/ Multica autopilot 配置(YAML,多 profile 共用)
|
└── 🔧 scripts/
|
||||||
│ ├── atlas-daily-brief.yaml
|
└── mirror-nuwa-to-moments.sh 一键镜像 nuwa-skill 到 Moments Gitea
|
||||||
│ ├── 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/`
|
| 维度 | Atlas |
|
||||||
每个 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
|
| **数据源** | 邮件(V0)→ 微信(V0.5)→ 飞书(V1) |
|
||||||
|
| **学习成本** | 0(老板照常发邮件,AI 在后台读) |
|
||||||
|
| **首份交付** | W1 末:"过去一年项目盘点 + 落地率诊断"报告 |
|
||||||
|
| **日常节奏** | 每天 7:30 一封 5 分钟看完的 Brief |
|
||||||
|
| **北极星指标** | 老板看完 Brief 能立刻说出今日 3 件事 |
|
||||||
|
| **部署模型** | 100% 客户私有部署,每客户一个独立实例 |
|
||||||
|
|
||||||
#### `tools/`
|
引用 10 套主流管理框架(GTD / RACI / Andy Grove / 9-Box / BARS / CCAR / ONA / CHS / VoC / WBR),每条 AI 判定都标依据规则号,老板 override 一行邮件就生效。
|
||||||
- `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**
|
- **Issue / 任务流转走 Multica**:所有给 Atlas 的需求、反馈、复盘走 Multica 的 issue + comment,不在仓库里开 issue
|
||||||
- **改动走 PR**:`prompts/`、`skills/`、`tools/`、`autopilots/`、`atlas/` 下的内容都进 production,必须 PR + review,不直接 push main
|
- **改动走 PR**:根目录文件、`skills/`、`mcp-tools/`、`autopilots/`、`state-schemas/` 下的内容都进 production,必须 PR + review
|
||||||
- **Atlas profile 是按客户实例化部署的**:每个客户的 `state/` 永远在客户机器上,不进本仓库
|
- **每客户实例隔离**:每个客户的 `state/`(projects/people/customers/runs/audit)永远在客户机器上,不进本仓库
|
||||||
- **保持 lean**:宁可少加,也不堆没人用的脚手架
|
- **保持 lean**:宁可少加,也不堆没人用的脚手架
|
||||||
|
- **永不放宽硬边界**:SOUL.md + 各 SKILL.md `boundaries:` 字段是死线(不评级员工 / 不写邮件给非老板 / 跨客户隔离 / 不编造证据)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🔗 相关
|
## 🔗 相关
|
||||||
|
|
||||||
- **Multica project**:总助 Claw(`fdc928a7-d204-4a9f-929e-2c59bea9cda3`)
|
- **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 心智蒸馏方法论的来源
|
- [`alchaincyf/nuwa-skill`](https://github.com/alchaincyf/nuwa-skill)(MIT)—— 心智蒸馏方法论
|
||||||
- [`NousResearch/hermes-agent`](https://github.com/NousResearch/hermes-agent)(MIT)—— 推荐运行时
|
- [`NousResearch/hermes-agent`](https://github.com/NousResearch/hermes-agent)(MIT)—— 推荐运行时
|
||||||
- **agentskills.io 标准**:https://agentskills.io
|
- **agentskills.io 标准**:https://agentskills.io
|
||||||
- **Atlas 北极星**:老板每天 5 分钟看完日 Brief,能立刻说出今日 3 件事
|
- **Mirror(air-gapped 客户部署用)**:`https://git.moments.top/Moments.top/nuwa-skill`(待建)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🗺️ 路线图
|
## 🗺️ 路线图
|
||||||
|
|
||||||
### Atlas
|
### 已完成
|
||||||
- [x] OpenClaw 8 件套 + 6 sub-skill 设计
|
- [x] OpenClaw 8 件套 + 6 sub-skill 设计
|
||||||
- [x] email-extractor V0(Stage 1-3 实现 + 7 测试通过)
|
- [x] email-extractor V0(Stage 1-3 实现 + 7 测试通过)
|
||||||
- [x] boss-distiller demo run(10 封邮件 → 5 层蒸馏验证)
|
- [x] boss-distiller demo run(10 封邮件 → 5 层蒸馏验证)
|
||||||
- [x] 客户演示 deck v1
|
- [x] 客户演示 deck v1
|
||||||
- [x] Hermes 集成 SOP
|
- [x] Hermes 集成 SOP
|
||||||
- [ ] **nuwa-skill 镜像到 Moments Gitea**(仓库已建则一键 `scripts/mirror-nuwa-to-moments.sh`)
|
- [x] state schemas(project / person / customer)
|
||||||
- [ ] email-extractor Stage 4-7(threading / entities / intent / canonical)
|
- [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 的可执行实现(当前是设计文档)
|
- [ ] 6 个 sub-skill 的可执行实现(当前是设计文档)
|
||||||
- [ ] `atlas-extractor` 包成 MCP server
|
- [ ] `atlas-extractor` 包成 MCP server
|
||||||
|
- [ ] dogfood:装到内部 Hermes 实例端到端跑一次
|
||||||
- [ ] 第一个客户 W1 部署
|
- [ ] 第一个客户 W1 部署
|
||||||
|
|
||||||
### Vega
|
|
||||||
- [ ] system prompt 落到 `prompts/system.md`
|
|
||||||
- [ ] 抽出最常用的 3–5 个通用 skill
|
|
||||||
- [ ] 把现有 autopilot 反向导出到 `autopilots/`
|
|
||||||
- [ ] CI:对 `prompts/` 和 `skills/` 做 schema / lint 校验
|
|
||||||
|
|||||||
@ -1,40 +0,0 @@
|
|||||||
# 总助 Claw (Atlas) — Plan & Scaffold
|
|
||||||
|
|
||||||
Boss-perspective project execution radar. Built on the OpenClaw agent framework (mirrors `zero-cca/` structure).
|
|
||||||
|
|
||||||
## Quick Map
|
|
||||||
|
|
||||||
| Layer | Files |
|
|
||||||
|-------|-------|
|
|
||||||
| **Identity (8 OpenClaw core files)** | `IDENTITY.md` `SOUL.md` `USER.md` `AGENTS.md` `TOOLS.md` `MEMORY.md` `BOOTSTRAP.md` `HEARTBEAT.md` (+ `CLAUDE.md` symlink) |
|
|
||||||
| **Skills (6 sub-skills)** | `skills/{claw-email-parser, claw-project-tracker, claw-people-observer, claw-customer-radar, claw-boss-distiller, claw-report-writer}/SKILL.md` |
|
|
||||||
| **MCP tools** | `mcp-tools/email-extractor.md` (the deep-dive 7-stage extraction pipeline) + `mcp-tools/README.md` |
|
|
||||||
| **State (runtime)** | created at deployment under `state/` per-client |
|
|
||||||
| **Memory (runtime)** | created at deployment under `memory/` |
|
|
||||||
|
|
||||||
## Counts
|
|
||||||
|
|
||||||
- **1 Agent** (Atlas / 总助)
|
|
||||||
- **6 Skills** (1 master would re-enter via entry points A/B/C/D/E)
|
|
||||||
- **6 MCP tools** (email-fetch, email-extractor, state-io, report-render, email-send, rule-audit)
|
|
||||||
- **5 Autopilot schedules** (daily / weekly / monthly / quarterly + event-triggered)
|
|
||||||
- **3 State entity types** (project / person / customer) + audit + runs + extracted
|
|
||||||
- **5 Report modes** (daily / weekly / monthly / inventory / ad-hoc)
|
|
||||||
- **5 Layers** in `boss_skill.md` (Expression DNA / Mental Models / Decision Heuristics / Anti-Patterns / Honest Boundaries)
|
|
||||||
- **1 Open-source dependency** (`nuwa-skill` MIT, vendored into `claw-boss-distiller`)
|
|
||||||
|
|
||||||
## Read Order for a New Atlas Operator
|
|
||||||
|
|
||||||
1. `BOOTSTRAP.md` (first run only)
|
|
||||||
2. `SOUL.md` (boundaries — read once, internalize)
|
|
||||||
3. `IDENTITY.md` (role)
|
|
||||||
4. `USER.md` (boss profile, filled at deployment)
|
|
||||||
5. `AGENTS.md` (entry points + skill roster + tool roster + autopilot)
|
|
||||||
6. `mcp-tools/email-extractor.md` (the unsexy but critical extraction layer)
|
|
||||||
7. `skills/README.md` then individual `SKILL.md`s
|
|
||||||
|
|
||||||
## Status
|
|
||||||
|
|
||||||
Scaffold v0.4 — generated 2026-05-09 from PRD v0.3 + nuwa-skill review + OpenClaw framework adoption.
|
|
||||||
|
|
||||||
Next: write `state-schemas/{project,person,customer}.md` formal JSON schemas, write the boss_skill.md seed template, and begin the W1 implementation sprint.
|
|
||||||
@ -6,16 +6,16 @@
|
|||||||
|
|
||||||
## Context
|
## Context
|
||||||
|
|
||||||
Atlas's `claw-boss-distiller` skill (under `atlas/skills/claw-boss-distiller/`) is
|
Atlas's `claw-boss-distiller` skill (under `skills/claw-boss-distiller/`) is
|
||||||
adapted from the open-source [`alchaincyf/nuwa-skill`](https://github.com/alchaincyf/nuwa-skill)
|
adapted from the open-source [`alchaincyf/nuwa-skill`](https://github.com/alchaincyf/nuwa-skill)
|
||||||
(MIT). It uses upstream's triple-verification methodology and skill template
|
(MIT). It uses upstream's triple-verification methodology and skill template
|
||||||
(see `atlas/skills/claw-boss-distiller/ADAPTER.md`).
|
(see `skills/claw-boss-distiller/ADAPTER.md`).
|
||||||
|
|
||||||
For deployment, each Atlas instance needs the upstream code:
|
For deployment, each Atlas instance needs the upstream code:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone --depth 1 https://github.com/alchaincyf/nuwa-skill.git \
|
git clone --depth 1 https://github.com/alchaincyf/nuwa-skill.git \
|
||||||
atlas/skills/claw-boss-distiller/upstream
|
skills/claw-boss-distiller/upstream
|
||||||
```
|
```
|
||||||
|
|
||||||
This works for environments with public internet. **It does not work for many
|
This works for environments with public internet. **It does not work for many
|
||||||
@ -53,11 +53,11 @@ After repo exists, run `./scripts/mirror-nuwa-to-moments.sh` to populate it.
|
|||||||
`autopilots/` once decided)
|
`autopilots/` once decided)
|
||||||
- Each Atlas deployment records the upstream commit SHA at install time so
|
- Each Atlas deployment records the upstream commit SHA at install time so
|
||||||
drift is auditable
|
drift is auditable
|
||||||
- README in `atlas/skills/claw-boss-distiller/upstream/` clearly notes the
|
- README in `skills/claw-boss-distiller/upstream/` clearly notes the
|
||||||
mirror is a downstream copy, with last-mirrored timestamp
|
mirror is a downstream copy, with last-mirrored timestamp
|
||||||
|
|
||||||
## References
|
## References
|
||||||
|
|
||||||
- Upstream: https://github.com/alchaincyf/nuwa-skill (MIT)
|
- Upstream: https://github.com/alchaincyf/nuwa-skill (MIT)
|
||||||
- Mirror script: `scripts/mirror-nuwa-to-moments.sh`
|
- Mirror script: `scripts/mirror-nuwa-to-moments.sh`
|
||||||
- Adapter notes: `atlas/skills/claw-boss-distiller/ADAPTER.md`
|
- Adapter notes: `skills/claw-boss-distiller/ADAPTER.md`
|
||||||
|
|||||||
@ -38,5 +38,5 @@ rm -rf "$WORKDIR"
|
|||||||
|
|
||||||
echo "✅ Mirror complete: $TARGET"
|
echo "✅ Mirror complete: $TARGET"
|
||||||
echo
|
echo
|
||||||
echo "Next: update atlas/skills/claw-boss-distiller/upstream/README.md to point"
|
echo "Next: update skills/claw-boss-distiller/upstream/README.md to point"
|
||||||
echo " air-gapped deployments at the Moments mirror instead of GitHub."
|
echo " air-gapped deployments at the Moments mirror instead of GitHub."
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user