ce9f27320a
This adds the full Atlas (总助 Claw / 老板视角项目执行雷达) scaffolding as a sibling profile to the existing Vega general-purpose assistant. All Atlas content lives under atlas/ to keep the existing top-level skeleton intact. What's included: - atlas/IDENTITY.md, SOUL.md, USER.md, AGENTS.md, MEMORY.md, BOOTSTRAP.md, HEARTBEAT.md, TOOLS.md (+ zh-CN mirrors) — full OpenClaw 8-piece set matching the zero-cca convention - atlas/skills/ — 6 sub-skills with frontmatter: claw-email-parser / claw-project-tracker / claw-people-observer / claw-customer-radar / claw-boss-distiller / claw-report-writer - atlas/skills/claw-boss-distiller/ — adapter notes for nuwa-skill, 5-layer boss_skill seed template (23 rules across Expression DNA / Mental Models / Decision Heuristics / Anti-Patterns / Honest Boundaries), and a complete synthetic distillation demo (10 input emails -> validated 5-layer output) - atlas/mcp-tools/email-extractor/ — Python implementation of stages 1-3 (fetch + decode + dequote), 7 pytest tests passing, CLI: atlas-extract - atlas/state-schemas/ — formal JSON schemas for project / person / customer cards with the no-employee-rating hard constraint baked in - atlas/client-deck/ — 2-page client-facing pitch document - autopilots/atlas-*.yaml — 5 autopilot configs (daily / weekly / monthly / quarterly + andon event-triggered) for a future Multica-side scheduler Notes: - nuwa-skill (MIT, https://github.com/alchaincyf/nuwa-skill) NOT vendored; fetch at deploy time via instructions in atlas/skills/claw-boss-distiller/upstream/README.md - Vega-side prompts/skills/tools/autopilots/docs scaffold left untouched - Top-level README.md updated with a brief Atlas pointer; rest preserved
64 lines
2.8 KiB
Markdown
64 lines
2.8 KiB
Markdown
# TOOLS.md - Atlas Tool Configuration
|
|
|
|
_Each Atlas instance is deployed inside the client's network. Tool credentials and endpoints are configured at install time._
|
|
|
|
## Communication
|
|
|
|
- **Primary channel to boss:** Email (Brief delivered to boss's inbox, signed `Atlas / 总助`)
|
|
- **Andon alerts:** Email + (optional) WeChat push via 企业微信 robot webhook
|
|
- **Boss override channel:** Boss replies to Brief email; Atlas parses reply for `OVERRIDE: <rule-id> <new-value>` markers
|
|
|
|
## Email Ingestion (Read-Only)
|
|
|
|
| Tool | Status | Notes |
|
|
|------|--------|-------|
|
|
| **email-fetch (IMAP)** | V0 default | Standard IMAP/SSL; supports incremental UID sync |
|
|
| **email-fetch (Gmail API)** | V0 alternative | OAuth2; more reliable than IMAP for Gmail |
|
|
| **email-fetch (Exchange / EWS / MS Graph)** | V0 alternative | For corporate Exchange / O365 |
|
|
| **wechat-fetch** | V0.5 | Read-only; via 企业微信 API or third-party MCP server |
|
|
| **feishu-fetch** | V1 | 飞书开放平台 OpenAPI |
|
|
|
|
## Email Extraction Pipeline
|
|
|
|
See `mcp-tools/email-extractor.md` for the full design (7-stage pipeline).
|
|
|
|
## State Storage
|
|
|
|
- **Backend:** Filesystem JSON (V0). SQLite migration at `>1000 projects` (~30-line script).
|
|
- **Location:** `state/` under workspace root, never outside client network.
|
|
- **Backup:** `git` repo (private, client-controlled). State changes commit nightly with `daily-snapshot` tag.
|
|
|
|
## Report Rendering
|
|
|
|
| Tool | Output |
|
|
|------|--------|
|
|
| **report-render (markdown→PDF)** | For attachable Brief PDF |
|
|
| **report-render (markdown→HTML inline-email)** | For email body |
|
|
| **report-render (markdown→WeChat-card)** | V0.5 — when WeChat output enabled |
|
|
|
|
## Mental Model Distillation
|
|
|
|
- **claw-boss-distiller** — vendored from `nuwa-skill` (MIT). Reads boss outgoing email corpus → 5-layer `boss_skill.md`.
|
|
- Refresh cadence: quarterly + on-demand.
|
|
|
|
## Audit & Observability
|
|
|
|
- **rule-audit** — append-only log: which rules fired, on which emails, producing which judgments. Boss can grep this.
|
|
- **state-diff** — between any two daily snapshots, render a state-change diff (which projects flipped state, which alerts fired).
|
|
|
|
## Model Providers
|
|
|
|
- **Primary LLM:** Configurable per client deployment. Default: Claude Sonnet 4.6 for daily runs, Claude Opus 4.7 for quarterly distillation.
|
|
- **Embedding (V1 only):** for L3 semantic retrieval, not in V0.
|
|
|
|
## Network & Privacy
|
|
|
|
- **Air-gapped option:** All processing inside client VPC; only Brief PDF leaves network (delivered to boss's inbox).
|
|
- **DPA required:** Data Processing Agreement signed before W1.
|
|
- **Data retention:** Raw email cache 90 days; extracted state files indefinite (client-owned).
|
|
- **Right-to-delete:** Single command wipes all Atlas state for a person / customer / project.
|
|
|
|
---
|
|
|
|
_Update this file whenever a tool integration is added, configured, or deprecated._
|