Hermes-compatible skill format + nuwa mirror prep + README rewrite

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.
2026-05-09 17:21:31 +08:00 · 2026-05-09 17:21:31 +08:00 · 04e197c896
commit 04e197c896
parent ce9f27320a
11 changed files with 486 additions and 62 deletions
--- a/README.md
+++ b/README.md
@ -1,91 +1,190 @@
 # assistant-claw（总助Claw）

-总助 Claw 的"配置中心"——同时承载两个 agent profile：
+> "把太多不了了之的事，重新装回老板的视野里。"

- **Vega** —— 通用助理（general-purpose teammate，原 README 设定）
- **Atlas** —— 老板视角项目执行雷达（new；详见 [`atlas/README.md`](./atlas/README.md)）
+`assistant-claw` 是 Moments / 莫曼茨智能科技的**总助 Claw 配置中心**，一个仓库装两个 agent profile：

-两个 profile 共用本仓库的目录约定（prompts / skills / tools / autopilots / docs），但 Atlas 是按客户实例化部署的纵向产品，所有 Atlas 特有资产（OpenClaw 8 件套 + 6 个子 skill + email-extractor + boss_skill 蒸馏 demo + 客户演示 deck）封装在 [`atlas/`](./atlas/) 子目录里。Vega 的内容继续按原计划长在顶层。
+| Profile | 角色 | 状态 | 入口 |
+|---------|------|------|------|
+| **Atlas** 🦅 | 老板视角项目执行雷达——按客户部署的纵向产品 | 设计 + 邮件抽取实现 + 蒸馏 demo 完成 | [`atlas/`](./atlas/) |
+| **Vega** ⭐ | 通用助理 agent——莫曼茨内部多面手 | 骨架占位 | [`prompts/`](./prompts/) `skills/` `tools/` |

-Atlas 部署时建议直接 `cd atlas && cat README.md` 走它的部署 SOP；本仓库根目录的下面这份 Vega 配置说明保持不变。
+两个 profile 共用本仓库的目录约定（prompts / skills / tools / autopilots / docs），**Atlas 资产隔离在 `atlas/` 子目录**，避免污染 Vega 的演进路径。

 ---

-总助 Claw 的"配置中心"——管理 Vega（通用助理 Agent）的全部可托管内容：
+## 📍 想做什么 → 看哪里

- **prompts/** — 系统提示词、人格设定、风格 guideline
- **skills/** — 可复用的 skill 定义（Markdown + frontmatter）
- **tools/** — Vega 调用的工具：MCP 服务配置、自定义 CLI 脚本、HTTP 工具适配
- **autopilots/** — 定时 / 触发式自动任务（对应 Multica `multica autopilot` 的配置）
- **docs/** — 设计文档、ADR、运行手册
+| 目标 | 路径 |
+|------|------|
+| 看 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/` |

-> Vega 在 Multica workspace 里的 agent ID 是 `877b1ea4-d096-4323-9ccc-cda31a3a7b3d`，归属 project **总助Claw**（`fdc928a7-d204-4a9f-929e-2c59bea9cda3`）。她和其他垂直 Claw（`research-claw`、`trainer-claw`、`geo-claw`）并列，但 scope 故意更宽：日常杂活、轻量编码、写作、调研、规划、跨工具协作。
+---

-## 仓库结构
+## 🚀 快速启动 — 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
-├── prompts/         # 系统提示词、人格、风格
-│   └── system.md         # 单一可信源（待落地）
-├── skills/          # 可触发的 skill 集合
-│   └── <skill-name>/
-│       └── SKILL.md      # 含 frontmatter: name / description / type
-├── tools/           # Vega 调用的工具
-│   ├── mcp/              # MCP server 配置
-│   └── scripts/          # 自定义 CLI / shell 脚本
-├── autopilots/      # 定时 / 触发的 autopilot 定义
-│   └── <name>.yaml       # title / agent / mode / schedule / payload
-└── docs/
-    └── decisions/        # ADR
+    ├── 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
 ```

-各目录现在用 `.gitkeep` 占位，会随后补齐。
+### 内容约定

-## 内容类型说明
+#### `prompts/` — system prompt + 人格
+单一可信源。线上 agent 的 prompt 应该从这里发布，不直接在 Multica 后台手动编辑。

-### prompts/
-Vega 的 system prompt 与人格设定，唯一可信源。线上 agent 的 prompt 应该从这里发布，而不是直接在 Multica 后台手动编辑。
-
-### skills/
+#### `skills/`
 每个 skill 一个子目录，至少包含 `SKILL.md`，frontmatter 必须有：
 - `name` — 唯一短名（kebab-case）
- `description` — 一行触发说明（用于决定何时调用，写得越具体越好）
- `type` — `rigid`（必须严格遵循） 或 `flexible`（按情境调整）
+- `description` — 一行触发说明
+- 可选增强字段（推荐）：`version`、`author`、`license`、`metadata.hermes.{tags, category, related_skills, boundaries}` —— 这些让 skill 兼容 [agentskills.io](https://agentskills.io) 和 Hermes Agent

-Skill 必须能给出一个具体的 trigger 场景；写不出来的就不要加。
+#### `tools/`
+- `tools/mcp/` — MCP server 配置
+- `tools/scripts/` — Vega 通过 Bash 调用的自定义脚本

-### tools/
- `tools/mcp/` — MCP server 的连接配置（command、env、scope 等）
- `tools/scripts/` — Vega 通过 Bash 调用的自定义脚本，每个脚本顶部一段说明 + 用法示例
-
-### autopilots/
-对应 `multica autopilot create` 的配置文件，每个 autopilot 一个 YAML/JSON：
- `title`、`description`、`agent`、`mode`（默认 `create_issue`）
- `schedule`（cron 或 trigger 描述）
- `payload` / `template`（每次触发时落到 issue 的内容模板）
+#### `autopilots/`
+对应 `multica autopilot create` 的配置文件，一个 autopilot 一个 YAML：
+- `title`、`description`、`agent`、`mode`
+- `schedule`（cron 或事件触发）
+- `payload` / `delivery`
+- `guardrails`

 发布时通过脚本读这些文件批量调 `multica autopilot create/update`，避免漂移。

-### docs/
-设计决策（ADR）、运行手册、复盘记录。改 `prompts/` 或 `skills/` 之前先写一段 ADR，比事后追溯便宜。
+#### `docs/decisions/` — ADR
+改动 prompts / skills / tools 之前先写一段 ADR，比事后追溯便宜。

-## 工作约定
+---

- **Issue / 任务流转走 Multica**：所有给 Vega 的任务、反馈、复盘走 Multica 的 issue + comment，**不在仓库里开 issue**。
- **改动走 PR**：`prompts/`、`skills/`、`tools/`、`autopilots/` 下的内容都会进 production，必须 PR + review，不直接 push main。
- **保持 lean**：宁可少加，也不堆没人用的脚手架。每加一个 skill / tool / autopilot 都要能回答："谁在什么场景下会触发它"。
+## ⚙️ 工作约定

-## 路线图（暂定）
+- **Issue / 任务流转走 Multica**：所有给 agent 的任务、反馈、复盘走 Multica 的 issue + comment，**不在仓库里开 issue**
+- **改动走 PR**：`prompts/`、`skills/`、`tools/`、`autopilots/`、`atlas/` 下的内容都进 production，必须 PR + review，不直接 push main
+- **Atlas profile 是按客户实例化部署的**：每个客户的 `state/` 永远在客户机器上，不进本仓库
+- **保持 lean**：宁可少加，也不堆没人用的脚手架

- [ ] 把当前 Vega 的 system prompt 落到 `prompts/system.md`
- [ ] 抽出最常用的 3–5 个 skill 到 `skills/`（issue triage、comment drafting、研究汇总等）
- [ ] 把现有 autopilot 反向导出到 `autopilots/`，建立"配置即代码"基线
- [ ] `docs/decisions/0001-why-general-agent.md`：为什么是通用 agent 而不是又一个垂直 claw
+---
+
+## 🔗 相关
+
+- **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 校验
- [ ] 发布脚本：从 `autopilots/*.yaml` 批量同步到 Multica
-
-## 相关链接
-
- Multica project：总助Claw（`fdc928a7-d204-4a9f-929e-2c59bea9cda3`）
- 兄弟仓库：`research-claw` / `trainer-claw` / `geo-claw`
--- a/atlas/INTEGRATION-hermes.md
+++ b/atlas/INTEGRATION-hermes.md
@ -0,0 +1,122 @@
+# Hermes Agent Integration
+
+Atlas can run on **[hermes-agent](https://github.com/NousResearch/hermes-agent)**
+(MIT, by Nous Research) as the host runtime. Hermes provides exactly what Atlas
+needs: agentskills.io-compatible skill loader, cron scheduler, MCP client,
+multi-platform delivery (incl. email/feishu/dingtalk), session memory + FTS5,
+and subagent delegation.
+
+This doc tells the operator how to install Atlas on top of Hermes in ≤ 30 minutes.
+
+## What you need
+
+- Hermes installed: `curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash`
+- Python 3.10+ (for `atlas-extractor` MCP wrapper)
+- This repo (`assistant-claw`) cloned
+
+## Step 1 — Drop Atlas skills into Hermes skills dir
+
+```bash
+# Hermes scans ~/.hermes/skills/ on startup
+mkdir -p ~/.hermes/skills/atlas
+cp -r atlas/skills/* ~/.hermes/skills/atlas/
+
+# Check Hermes sees them
+hermes skills list | grep claw-
+```
+
+Each `claw-*/SKILL.md` already has the agentskills.io-compatible frontmatter
+(`name`, `description`, `version`, `author`, `license`, `metadata.hermes.*`)
+so Hermes recognizes them immediately.
+
+## Step 2 — Fetch the nuwa-skill upstream once
+
+```bash
+# Public deployment
+git clone --depth 1 https://github.com/alchaincyf/nuwa-skill.git \
+  ~/.hermes/skills/atlas/claw-boss-distiller/upstream
+
+# Air-gapped deployment (after Moments mirror is up — see ADR-0001)
+git clone --depth 1 https://git.moments.top/Moments.top/nuwa-skill.git \
+  ~/.hermes/skills/atlas/claw-boss-distiller/upstream
+```
+
+## Step 3 — Install atlas-extractor as an MCP server (TBD code)
+
+The `atlas/mcp-tools/email-extractor/` Python package currently exposes a CLI
+(`atlas-extract`). Wrapping it as an MCP server is V0.5 work; until then
+Hermes can call the CLI via Bash.
+
+```bash
+cd atlas/mcp-tools/email-extractor
+python -m venv .venv
+.venv/bin/pip install -e '.[test]'
+.venv/bin/pytest -q   # confirm 7/7 passing
+```
+
+## Step 4 — Configure the boss's email account
+
+```bash
+hermes env set BOSS_EMAIL boss@clientco.com
+hermes env set ATLAS_IMAP_HOST imap.clientco.com
+hermes env set ATLAS_IMAP_USER atlas-readonly@clientco.com
+hermes env set ATLAS_IMAP_PASSWORD <app-password>     # never main password
+hermes env set ATLAS_STATE_DIR ~/.atlas/state
+```
+
+## Step 5 — Wire the autopilots into Hermes cron
+
+Atlas's 5 autopilot YAMLs live in `../autopilots/atlas-*.yaml`. Translate each
+into Hermes natural-language cron:
+
+```bash
+hermes cron add "every day 7:30" "Run Atlas daily-brief skill"
+hermes cron add "every monday 8:00" "Run Atlas weekly-rollup skill"
+hermes cron add "every month on 1st 9:00" "Run Atlas monthly customer-health skill"
+hermes cron add "every quarter on 1st 10:00" "Run Atlas boss_skill quarterly refresh"
+```
+
+Andon (event-triggered) is set up via `hermes hooks add` once Atlas writes a
+sentinel file like `~/.atlas/state/runs/_andon_pending.flag`.
+
+## Step 6 — Smoke test
+
+```bash
+# Manually invoke claw-boss-distiller on the demo input
+hermes "Run claw-boss-distiller on atlas/skills/claw-boss-distiller/demo/INPUT/ \
+        and write the result to atlas/skills/claw-boss-distiller/demo/OUTPUT/boss_skill.live.md"
+
+# Check it produced a 5-layer doc
+diff atlas/skills/claw-boss-distiller/demo/OUTPUT/boss_skill.demo.md \
+     atlas/skills/claw-boss-distiller/demo/OUTPUT/boss_skill.live.md
+```
+
+## Step 7 — First Daily Brief
+
+Wait until the next scheduled 7:30, OR force-run:
+
+```bash
+hermes "Run Atlas daily-brief now and email it to ${BOSS_EMAIL}"
+```
+
+The boss receives a 5-minute Brief in their inbox.
+
+## Caveats
+
+1. **Hermes self-improving loop** — Hermes can auto-edit its own skills based
+   on usage. **Lock down `SOUL.md` and the SKILL.md `boundaries:` list** by
+   adding them to Hermes's skill-write deny list. We never want Atlas to
+   auto-relax its own guardrails.
+
+2. **Branding** — Hermes's default identity is "Hermes Agent by Nous Research".
+   Override the system prompt to introduce as "Atlas / 总助 Claw" for client
+   deployments. See `hermes_cli/skin_engine.py` for theming hooks.
+
+3. **Execution environment** — Use `local` or `docker` backends only for
+   client-internal deployments. SSH / Daytona / Modal assume external network.
+
+## Roadmap
+
+- [ ] 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
+- [ ] V1: Build a Hermes "skill pack" installer (`hermes skills install moments/atlas`)
--- a/atlas/skills/DESCRIPTION.md
+++ b/atlas/skills/DESCRIPTION.md
@ -0,0 +1,36 @@
+---
+description: >
+  Atlas (总助 Claw) — boss-perspective project execution radar. Six sub-skills
+  that turn raw email into a 3D map of "people × project × customer", surface
+  what's slipping, and write a 5-minute daily Brief in the boss's voice.
+  Compatible with Hermes Agent (agentskills.io standard) and OpenClaw runtime.
+metadata:
+  hermes:
+    category: atlas
+    tags: [boss-radar, project-tracking, gtd, raci, 9-box, customer-health, ona]
+---
+
+# Atlas Sub-Skills
+
+Six skills work in pipeline:
+
+```
+[email-parser] → [project-tracker] → [people-observer] → [customer-radar]
+                          ↓                  ↓                 ↓
+                          └──────────────────┴─────────────────┘
+                                            ↓
+                                  [boss-distiller]   (quarterly)
+                                            ↓
+                                   [report-writer]   (daily/weekly/monthly)
+```
+
+| Skill | Job |
+|-------|-----|
+| `claw-email-parser` | Fetch + extract canonical Email JSON |
+| `claw-project-tracker` | Cluster threads → projects, GTD/RACI, state |
+| `claw-people-observer` | 9-Box / BARS / CCAR / ONA — never assigns ratings |
+| `claw-customer-radar` | CHS / VoC / churn — fires Andon alerts |
+| `claw-boss-distiller` | nuwa-skill derivative, distill boss mental model |
+| `claw-report-writer` | Daily / Weekly / Monthly briefs in boss's voice |
+
+See each `claw-*/SKILL.md` for inputs/outputs, judgment rules, and failure modes.
--- a/atlas/skills/claw-boss-distiller/SKILL.md
+++ b/atlas/skills/claw-boss-distiller/SKILL.md
@ -1,6 +1,18 @@
 ---
 name: claw-boss-distiller
 description: Distill the boss's mental model from outgoing email corpus into a 5-layer boss_skill.md (Expression DNA / Mental Models / Decision Heuristics / Anti-Patterns / Honest Boundaries). Derived from nuwa-skill (MIT). Drafts only — boss confirms every change.
+version: 0.1.0
+author: Moments / Atlas team (adapted from alchaincyf/nuwa-skill, MIT)
+license: MIT
+metadata:
+  hermes:
+    category: atlas
+    tags: [mental-model, distillation, nuwa, boss-os, atlas]
+    related_skills: [claw-email-parser, claw-report-writer]
+    upstream_dependency: alchaincyf/nuwa-skill
+    boundaries:
+      - all_new_rules_default_to_status_draft
+      - never_apply_changes_without_explicit_boss_confirm
 ---

 # claw-boss-distiller
--- a/atlas/skills/claw-customer-radar/SKILL.md
+++ b/atlas/skills/claw-customer-radar/SKILL.md
@ -1,6 +1,16 @@
 ---
 name: claw-customer-radar
 description: Compute Customer Health Score, sentiment trend, RFM, decision-chain map, churn signals. Fire Andon alerts when health crosses thresholds.
+version: 0.1.0
+author: Moments / Atlas team
+license: MIT
+metadata:
+  hermes:
+    category: atlas
+    tags: [customer-success, chs, voc, churn, rfm, andon, atlas]
+    related_skills: [claw-email-parser, claw-project-tracker, claw-report-writer]
+    boundaries:
+      - cross_customer_data_isolation
 ---

 # claw-customer-radar
--- a/atlas/skills/claw-email-parser/SKILL.md
+++ b/atlas/skills/claw-email-parser/SKILL.md
@ -1,6 +1,14 @@
 ---
 name: claw-email-parser
 description: Wraps the email-extractor MCP tool; orchestrates fetch → extract → write canonical Email JSON. The thin LLM layer that decides what to do with low-confidence extractions.
+version: 0.1.0
+author: Moments / Atlas team
+license: MIT
+metadata:
+  hermes:
+    category: atlas
+    tags: [email, imap, extraction, atlas, intake]
+    related_skills: [claw-project-tracker, claw-people-observer, claw-customer-radar]
 ---

 # claw-email-parser
--- a/atlas/skills/claw-people-observer/SKILL.md
+++ b/atlas/skills/claw-people-observer/SKILL.md
@ -1,6 +1,18 @@
 ---
 name: claw-people-observer
 description: Compute observation cards for each person — project density, response time, BARS behavior tags, CCAR critical incidents, ONA centrality, 9-Box performance dimension. NEVER assigns potential or final ratings — those are boss-only.
+version: 0.1.0
+author: Moments / Atlas team
+license: MIT
+metadata:
+  hermes:
+    category: atlas
+    tags: [people-analytics, 9-box, bars, ccar, ona, atlas]
+    related_skills: [claw-email-parser, claw-project-tracker, claw-report-writer]
+    boundaries:
+      - never_assign_9box_potential
+      - never_assign_topgrading_grade
+      - never_recommend_pip_or_termination
 ---

 # claw-people-observer
--- a/atlas/skills/claw-project-tracker/SKILL.md
+++ b/atlas/skills/claw-project-tracker/SKILL.md
@ -1,6 +1,14 @@
 ---
 name: claw-project-tracker
 description: Cluster threads into project entities, apply GTD/RACI logic, judge project state (Active/Stalled/Completed/Someday/Dropped) with rule citations.
+version: 0.1.0
+author: Moments / Atlas team
+license: MIT
+metadata:
+  hermes:
+    category: atlas
+    tags: [project-management, gtd, raci, atlas, boss-perspective]
+    related_skills: [claw-email-parser, claw-people-observer, claw-customer-radar, claw-report-writer]
 ---

 # claw-project-tracker
--- a/atlas/skills/claw-report-writer/SKILL.md
+++ b/atlas/skills/claw-report-writer/SKILL.md
@ -1,6 +1,18 @@
 ---
 name: claw-report-writer
 description: Render Daily Brief / Weekly Rollup / Monthly Customer Health / one-time Inventory in Amazon WBR style with rule citations. Speaks in the boss's voice (Layer 1 of boss_skill.md).
+version: 0.1.0
+author: Moments / Atlas team
+license: MIT
+metadata:
+  hermes:
+    category: atlas
+    tags: [reporting, wbr, daily-brief, atlas, boss-voice]
+    related_skills: [claw-project-tracker, claw-people-observer, claw-customer-radar, claw-boss-distiller]
+    delivery_channels: [email, feishu, dingtalk, wechat]
+    boundaries:
+      - send_only_to_boss
+      - cite_every_judgment
 ---

 # claw-report-writer
--- a/docs/decisions/0001-mirror-nuwa-skill.md
+++ b/docs/decisions/0001-mirror-nuwa-skill.md
@ -0,0 +1,63 @@
+# ADR-0001: Mirror nuwa-skill into Moments private Gitea
+
+**Date:** 2026-05-09
+**Status:** Accepted
+**Authors:** Atlas team
+
+## Context
+
+Atlas's `claw-boss-distiller` skill (under `atlas/skills/claw-boss-distiller/`) is
+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
+(see `atlas/skills/claw-boss-distiller/ADAPTER.md`).
+
+For deployment, each Atlas instance needs the upstream code:
+
+```bash
+git clone --depth 1 https://github.com/alchaincyf/nuwa-skill.git \
+  atlas/skills/claw-boss-distiller/upstream
+```
+
+This works for environments with public internet. **It does not work for many
+enterprise client deployments** which Atlas explicitly targets — most of our
+customer base operates inside corporate networks that block direct GitHub access.
+
+## Decision
+
+Mirror `alchaincyf/nuwa-skill` to `git.moments.top/Moments.top/nuwa-skill` and
+treat the Moments mirror as the canonical fetch source for client deployments.
+
+The bot account (`multica-bot`) cannot create org repos via API (lacks
+`write:organization` scope). Repo creation is a one-time human step:
+
+> https://git.moments.top/repo/create → owner: `Moments.top` → name: `nuwa-skill`
+> → empty (no auto-init)
+
+After repo exists, run `./scripts/mirror-nuwa-to-moments.sh` to populate it.
+
+## Consequences
+
+### Positive
+- Air-gapped client deployments work (no GitHub access required)
+- Stable fetch URL even if upstream is unavailable
+- Allows pinning to a specific commit per-deployment if needed
+- We retain MIT license attribution (no IP impact)
+
+### Negative
+- Adds a sync responsibility — when upstream evolves, we need to re-mirror
+- Slight risk of staleness if mirror cron fails silently
+
+## Mitigation
+
+- Run `./scripts/mirror-nuwa-to-moments.sh` on a weekly cron (TBD: add to
+  `autopilots/` once decided)
+- Each Atlas deployment records the upstream commit SHA at install time so
+  drift is auditable
+- README in `atlas/skills/claw-boss-distiller/upstream/` clearly notes the
+  mirror is a downstream copy, with last-mirrored timestamp
+
+## References
+
+- Upstream: https://github.com/alchaincyf/nuwa-skill (MIT)
+- Mirror script: `scripts/mirror-nuwa-to-moments.sh`
+- Adapter notes: `atlas/skills/claw-boss-distiller/ADAPTER.md`
--- a/scripts/mirror-nuwa-to-moments.sh
+++ b/scripts/mirror-nuwa-to-moments.sh
@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# Mirror github.com/alchaincyf/nuwa-skill (MIT) into Moments private Gitea.
+#
+# Why we mirror: Atlas's claw-boss-distiller depends on nuwa-skill methodology
+# (`references/extraction-framework.md`). For air-gapped client deployments where
+# the client network cannot reach github.com, our private Gitea must serve nuwa.
+#
+# Prereq: a destination repo on git.moments.top must already exist (empty).
+# Default target: https://git.moments.top/Moments.top/nuwa-skill.git
+#
+# Create it once via Gitea UI (the bot account doesn't have org-create scope):
+#   https://git.moments.top/repo/create  →  owner: Moments.top  →  name: nuwa-skill  →  empty
+#
+# Usage:
+#   ./scripts/mirror-nuwa-to-moments.sh
+#   ./scripts/mirror-nuwa-to-moments.sh https://git.moments.top/your-org/nuwa-skill.git
+#
+# After first mirror, schedule a weekly cron to re-mirror upstream changes.
+
+set -euo pipefail
+
+UPSTREAM="https://github.com/alchaincyf/nuwa-skill.git"
+TARGET="${1:-https://git.moments.top/Moments.top/nuwa-skill.git}"
+WORKDIR="$(mktemp -d -t nuwa-mirror-XXXXXX)"
+
+echo "Mirror $UPSTREAM → $TARGET"
+echo "Workdir: $WORKDIR"
+
+# Bare clone preserves all branches/tags/refs
+git clone --mirror "$UPSTREAM" "$WORKDIR"
+cd "$WORKDIR"
+
+# Push everything (--mirror = all refs incl. delete on remote)
+git push --mirror "$TARGET"
+
+cd /
+rm -rf "$WORKDIR"
+
+echo "✅ Mirror complete: $TARGET"
+echo
+echo "Next: update atlas/skills/claw-boss-distiller/upstream/README.md to point"
+echo "      air-gapped deployments at the Moments mirror instead of GitHub."