92 lines
4.9 KiB
Markdown
92 lines
4.9 KiB
Markdown
# assistant-claw（总助Claw）
|
||
|
||
总助 Claw 的"配置中心"——同时承载两个 agent profile：
|
||
|
||
- **Vega** —— 通用助理（general-purpose teammate，原 README 设定）
|
||
- **Atlas** —— 老板视角项目执行雷达（new；详见 [`atlas/README.md`](./atlas/README.md)）
|
||
|
||
两个 profile 共用本仓库的目录约定（prompts / skills / tools / autopilots / docs），但 Atlas 是按客户实例化部署的纵向产品，所有 Atlas 特有资产（OpenClaw 8 件套 + 6 个子 skill + email-extractor + boss_skill 蒸馏 demo + 客户演示 deck）封装在 [`atlas/`](./atlas/) 子目录里。Vega 的内容继续按原计划长在顶层。
|
||
|
||
Atlas 部署时建议先读 [`atlas/QUICKSTART.zh-CN.md`](./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
|
||
|
||
## 相关链接
|
||
|
||
- Multica project：总助Claw（`fdc928a7-d204-4a9f-929e-2c59bea9cda3`）
|
||
- 兄弟仓库：`research-claw` / `trainer-claw` / `geo-claw`
|