From 67368bcfbceca167719b0e187c372be7f073a0cb Mon Sep 17 00:00:00 2001
From: Vega <877b1ea4-d096-4323-9ccc-cda31a3a7b3d@agents.multica.ai>
Date: Sat, 9 May 2026 16:38:51 +0800
Subject: [PATCH] Scaffold repo: README, .gitignore,
 prompts/skills/tools/autopilots/docs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Initial structure for the 总助Claw (Vega) config repo. The repo is the
single source of truth for Vega's manageable content:
- prompts/      system prompt, persona, voice
- skills/       reusable skill definitions (Markdown + frontmatter)
- tools/        MCP servers and custom scripts Vega calls
- autopilots/   scheduled / triggered automations (mirrors multica autopilot)
- docs/         design decisions, runbooks

README documents scope, conventions (issues live in Multica, content
changes go via PR), and a near-term roadmap. .gitignore covers OS,
editor, env, Python, and Node noise. All directories use .gitkeep
placeholders.
---
 .gitignore          | 43 ++++++++++++++++++++++++
 README.md           | 80 ++++++++++++++++++++++++++++++++++++++++++++-
 autopilots/.gitkeep |  0
 docs/.gitkeep       |  0
 prompts/.gitkeep    |  0
 skills/.gitkeep     |  0
 tools/.gitkeep      |  0
 7 files changed, 122 insertions(+), 1 deletion(-)
 create mode 100644 .gitignore
 create mode 100644 autopilots/.gitkeep
 create mode 100644 docs/.gitkeep
 create mode 100644 prompts/.gitkeep
 create mode 100644 skills/.gitkeep
 create mode 100644 tools/.gitkeep

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..94240b7
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,43 @@
+# OS
+.DS_Store
+Thumbs.db
+
+# Editors
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Env / secrets
+.env
+.env.*
+!.env.example
+*.pem
+*.key
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Node
+node_modules/
+dist/
+build/
+.next/
+.turbo/
+*.log
+npm-debug.log*
+yarn-debug.log*
+pnpm-debug.log*
+
+# Misc
+.cache/
+coverage/
+*.tmp
diff --git a/README.md b/README.md
index 61127eb..61ae4d4 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,80 @@
-# assistant-claw
+# 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`
diff --git a/autopilots/.gitkeep b/autopilots/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/docs/.gitkeep b/docs/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/prompts/.gitkeep b/prompts/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/skills/.gitkeep b/skills/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/tools/.gitkeep b/tools/.gitkeep
new file mode 100644
index 0000000..e69de29