Kaden Lau 077646750b Add Atlas quickstart guide

Co-authored-by: multica-agent <github@multica.ai>

2026-05-09 18:20:31 +08:00

4.9 KiB

Raw Permalink Blame History

assistant-claw（总助Claw）

总助 Claw 的"配置中心"——同时承载两个 agent profile：

Vega —— 通用助理（general-purpose teammate，原 README 设定）
Atlas —— 老板视角项目执行雷达（new；详见 atlas/README.md）

两个 profile 共用本仓库的目录约定（prompts / skills / tools / autopilots / docs），但 Atlas 是按客户实例化部署的纵向产品，所有 Atlas 特有资产（OpenClaw 8 件套 + 6 个子 skill + email-extractor + boss_skill 蒸馏 demo + 客户演示 deck）封装在 atlas/ 子目录里。Vega 的内容继续按原计划长在顶层。

Atlas 部署时建议先读 atlas/QUICKSTART.zh-CN.md，再 cd atlas && cat README.md 走它的部署 SOP；本仓库根目录的下面这份 Vega 配置说明保持不变。

总助 Claw 的"配置中心"——管理 Vega（通用助理 Agent）的全部可托管内容：

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

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 故意更宽：日常杂活、轻量编码、写作、调研、规划、跨工具协作。

仓库结构

.
├── 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

各目录现在用 .gitkeep 占位，会随后补齐。

内容类型说明

prompts/

Vega 的 system prompt 与人格设定，唯一可信源。线上 agent 的 prompt 应该从这里发布，而不是直接在 Multica 后台手动编辑。

skills/

每个 skill 一个子目录，至少包含 SKILL.md，frontmatter 必须有：

name — 唯一短名（kebab-case）
description — 一行触发说明（用于决定何时调用，写得越具体越好）
type — rigid（必须严格遵循）或 flexible（按情境调整）

Skill 必须能给出一个具体的 trigger 场景；写不出来的就不要加。

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 的内容模板）

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

docs/

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

工作约定

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

路线图（暂定）

把当前 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
CI：对 prompts/ 和 skills/ 做 schema / lint 校验
发布脚本：从 autopilots/*.yaml 批量同步到 Multica

4.9 KiB Raw Permalink Blame History Unescape Escape