# assistant-claw（总助Claw）

总助 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`