@markus-global/cli 0.6.3 → 0.6.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/commands/start.d.ts.map +1 -1
- package/dist/commands/start.js +39 -11
- package/dist/commands/start.js.map +1 -1
- package/dist/markus.mjs +1214 -339
- package/dist/web-ui/assets/index-DcnwpDqb.css +1 -0
- package/dist/web-ui/assets/index-tONQYLWM.js +351 -0
- package/dist/web-ui/index.html +2 -2
- package/dist/web-ui/logo.png +0 -0
- package/package.json +1 -1
- package/templates/roles/SHARED.md +3 -6
- package/templates/roles/developer/POLICIES.md +1 -1
- package/templates/roles/secretary/HEARTBEAT.md +1 -1
- package/templates/roles/secretary/ROLE.md +80 -4
- package/templates/skills/agent-building/SKILL.md +1 -1
- package/templates/skills/chrome-devtools/SKILL.md +56 -0
- package/templates/skills/image-generation/SKILL.md +183 -0
- package/templates/skills/image-generation/server.mjs +1269 -0
- package/templates/skills/image-generation/skill.json +26 -0
- package/templates/skills/markus-admin-cli/SKILL.md +1 -1
- package/templates/skills/self-evolution/SKILL.md +4 -4
- package/templates/skills/skill-building/SKILL.md +1 -1
- package/templates/skills/team-building/SKILL.md +1 -1
- package/templates/teams/content-team/ANNOUNCEMENT.md +28 -24
- package/templates/teams/content-team/NORMS.md +50 -48
- package/templates/teams/content-team/team.json +46 -16
- package/templates/teams/research-lab/ANNOUNCEMENT.md +24 -19
- package/templates/teams/research-lab/NORMS.md +77 -88
- package/templates/teams/research-lab/team.json +40 -14
- package/dist/web-ui/assets/index-C97PujBE.js +0 -351
- package/dist/web-ui/assets/index-Q4_kHftV.css +0 -1
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
{
|
|
2
|
+
"type": "skill",
|
|
3
|
+
"name": "image-generation",
|
|
4
|
+
"displayName": "Image Generation",
|
|
5
|
+
"version": "1.0.0",
|
|
6
|
+
"description": "Generate images using AI models — supports 14 providers including OpenAI DALL-E, Stability AI, Google Imagen, Replicate, SiliconFlow, Together AI, FAL, Ideogram, Tongyi, Zhipu, Baidu, Hunyuan, Volcengine, and more",
|
|
7
|
+
"author": "markus",
|
|
8
|
+
"category": "creative",
|
|
9
|
+
"tags": ["image", "drawing", "dall-e", "stable-diffusion", "generation", "art", "mcp"],
|
|
10
|
+
"i18n": {
|
|
11
|
+
"zh-CN": {
|
|
12
|
+
"displayName": "AI 画图",
|
|
13
|
+
"description": "使用 AI 模型生成图片 — 支持 14 个平台:OpenAI DALL-E、Stability AI、Google Imagen、Replicate、SiliconFlow、Together AI、FAL、Ideogram、通义万相、智谱 CogView、百度文心、腾讯混元、火山引擎等"
|
|
14
|
+
}
|
|
15
|
+
},
|
|
16
|
+
"skill": {
|
|
17
|
+
"skillFile": "SKILL.md",
|
|
18
|
+
"requiredPermissions": ["network", "file"],
|
|
19
|
+
"mcpServers": {
|
|
20
|
+
"image-generation": {
|
|
21
|
+
"command": "node",
|
|
22
|
+
"args": ["${SKILL_DIR}/server.mjs"]
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -5,7 +5,7 @@ description: System administration via markus CLI — system controls, audit, us
|
|
|
5
5
|
|
|
6
6
|
# System Administration via CLI
|
|
7
7
|
|
|
8
|
-
> **NOTE**: Most admin CLI commands have no built-in tool equivalent — CLI is the primary interface for system administration. Use `
|
|
8
|
+
> **NOTE**: Most admin CLI commands have no built-in tool equivalent — CLI is the primary interface for system administration. Use `package_install`/`package_list` for package management when available.
|
|
9
9
|
|
|
10
10
|
## How to invoke
|
|
11
11
|
|
|
@@ -41,7 +41,7 @@ Skip trivial matters — typos, one-off path errors, situations that won't recur
|
|
|
41
41
|
| Tool tip or preference | Observation buffer | `memory_save` with tags: `["insight", "tool:<name>"]` |
|
|
42
42
|
| Validated pattern from successful task | Observation buffer | `memory_save` with tags: `["insight", ...]` |
|
|
43
43
|
| Multi-step repeatable workflow (personal) | MEMORY.md | `memory_update_longterm({ section: "<your-section>", mode: "patch" })` |
|
|
44
|
-
| Practice worth sharing with the team | Skill package | Create via **skill-building**, install with `
|
|
44
|
+
| Practice worth sharing with the team | Skill package | Create via **skill-building**, install with `package_install` |
|
|
45
45
|
| Behavioral rule or guiding principle | ROLE.md | `file_read` → `file_edit` to append |
|
|
46
46
|
| New recurring check for your patrol | HEARTBEAT.md | `file_read` → `file_edit` to add/remove items |
|
|
47
47
|
|
|
@@ -146,21 +146,21 @@ When a practice would benefit **other agents on the team** (not just you), packa
|
|
|
146
146
|
|
|
147
147
|
Before creating a new skill, check if one already exists:
|
|
148
148
|
1. Run `discover_tools({ mode: "list_skills" })` to see all installed skills
|
|
149
|
-
2. Run `
|
|
149
|
+
2. Run `package_list` to see packages in builder-artifacts
|
|
150
150
|
3. If a similar skill exists, **update it** instead of creating a new one
|
|
151
151
|
|
|
152
152
|
### How to Create and Install
|
|
153
153
|
|
|
154
154
|
1. Use the **skill-building** skill to create the package:
|
|
155
155
|
- Write `skill.json` manifest + `SKILL.md` instructions to `~/.markus/builder-artifacts/skills/{name}/`
|
|
156
|
-
2. Install with `
|
|
156
|
+
2. Install with `package_install({ type: "skill", name: "{name}" })`
|
|
157
157
|
3. Log the creation via `memory_save` with tags `["insight", "skill-created"]`
|
|
158
158
|
|
|
159
159
|
### How to Update an Existing Skill
|
|
160
160
|
|
|
161
161
|
1. Edit the files in `~/.markus/builder-artifacts/skills/{name}/` (use `file_read` then `file_edit`)
|
|
162
162
|
2. Bump the version in `skill.json` (e.g., `"1.0.0"` → `"1.1.0"`)
|
|
163
|
-
3. Re-install with `
|
|
163
|
+
3. Re-install with `package_install({ type: "skill", name: "{name}" })` — this overwrites the old version and re-registers
|
|
164
164
|
4. Log the update via `memory_save` with tags `["insight", "skill-updated"]`
|
|
165
165
|
|
|
166
166
|
Only create a skill when you are confident the practice is validated (proven across 2+ tasks) and genuinely useful for others.
|
|
@@ -150,7 +150,7 @@ file_write("~/.markus/builder-artifacts/skills/git-changelog/README.md", "# Git
|
|
|
150
150
|
Once all files are written, tell the user:
|
|
151
151
|
|
|
152
152
|
1. **The skill has been created and saved** — summarize what was created (name, purpose, what agents can do with it).
|
|
153
|
-
2. **Ready to install** — the user can install from the Builder page, or ask you to install it (you would use `
|
|
153
|
+
2. **Ready to install** — the user can install from the Builder page, or ask you to install it (you would use `package_install`). Do NOT install unless asked.
|
|
154
154
|
3. **To modify or improve** this skill (e.g., add more instructions, update examples, fix edge cases), just continue the conversation here — describe what you want to change and I'll update the files directly.
|
|
155
155
|
|
|
156
156
|
## Guidelines
|
|
@@ -189,7 +189,7 @@ file_write("~/.markus/builder-artifacts/teams/research-team/members/senior-resea
|
|
|
189
189
|
Once all files are written, tell the user:
|
|
190
190
|
|
|
191
191
|
1. **The team has been created and saved** — summarize the team composition (name, members, their roles).
|
|
192
|
-
2. **Ready to install** — the user can install from the Builder page, or ask you to install it (you would use `
|
|
192
|
+
2. **Ready to install** — the user can install from the Builder page, or ask you to install it (you would use `package_install`). Do NOT install unless asked.
|
|
193
193
|
3. **To modify or improve** this team (e.g., add new members, update roles, change team norms), just continue the conversation here — describe what you want to change and I'll update the files directly.
|
|
194
194
|
|
|
195
195
|
## Rules
|
|
@@ -1,24 +1,28 @@
|
|
|
1
|
-
# Content Creation Team
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
##
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
1
|
+
# 自媒体内容团队 — Content Creation Team
|
|
2
|
+
|
|
3
|
+
多平台自媒体内容创作团队,专注于微信公众号、知乎、小红书、X.com 和 LinkedIn 等多平台内容生产与运营。
|
|
4
|
+
|
|
5
|
+
## 团队结构
|
|
6
|
+
|
|
7
|
+
- **编辑(Editor)** — 选题策划、内容审核、发布排期、质量标准把控
|
|
8
|
+
- **中文写手(Chinese Writer)** — 微信公众号推文、知乎长文回答与文章
|
|
9
|
+
- **小红书运营(Xiaohongshu Operator)** — 图文笔记创作、短视频制作与发布
|
|
10
|
+
- **英文写手(English Writer)** — X.com 推文/Thread、LinkedIn 文章与帖子
|
|
11
|
+
- **通用内容创作者(General Content Creator)** — 多平台内容适配、素材复用、口播文案
|
|
12
|
+
|
|
13
|
+
## 工作流程
|
|
14
|
+
|
|
15
|
+
1. **编辑制定内容日历** — 基于热点趋势和品牌方向,制定月度选题规划
|
|
16
|
+
2. **并行创作** — 各平台写手独立创作,研发分析师提供资料支持和事实核查
|
|
17
|
+
3. **编辑审核** — 内容审核(准确性、调性、合规性),审核通过后发布
|
|
18
|
+
4. **发布与跟踪** — 各平台运营者负责发布,跟踪数据反馈
|
|
19
|
+
|
|
20
|
+
## 核心原则
|
|
21
|
+
|
|
22
|
+
- **受众优先** — 每个平台的内容要为该平台读者量身定制
|
|
23
|
+
- **素材复用** — 一个主题产出多平台版本,提高内容 ROI
|
|
24
|
+
- **数据驱动** — 根据发布数据调整内容策略
|
|
25
|
+
|
|
26
|
+
## 当前关注
|
|
27
|
+
|
|
28
|
+
等待编辑制定内容日历或接收来自利益相关者的内容需求。
|
|
@@ -1,48 +1,50 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
##
|
|
4
|
-
|
|
5
|
-
### 1.
|
|
6
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
### 2.
|
|
12
|
-
-
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
-
|
|
34
|
-
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
1
|
+
# 自媒体内容团队 — 工作规范
|
|
2
|
+
|
|
3
|
+
## 工作流:选题 → 创作 → 审核 → 发布 → 复盘
|
|
4
|
+
|
|
5
|
+
### 1. 选题与规划(编辑)
|
|
6
|
+
- 使用 `web_search` 研究各平台趋势、热点话题和竞争对手内容。
|
|
7
|
+
- 制定月度内容日历,包含:发布主题、目标平台、目标受众、关键时间节点。
|
|
8
|
+
- 使用 `task_create` 创建内容任务,明确 `assigned_agent_id` 和 `reviewer_id`。
|
|
9
|
+
- 内容日历作为 `deliverable_create` 发布,供全团队可见。
|
|
10
|
+
|
|
11
|
+
### 2. 并行创作(各写手,独立工作)
|
|
12
|
+
- **中文写手**:使用 `web_search` 和 `web_fetch` 收集素材,撰写公众号/知乎长文。
|
|
13
|
+
- **小红书运营**:使用 `xhs-posting` 技能创建图文笔记,注意图片配文和话题标签。
|
|
14
|
+
- **英文写手**:使用 `x-com-browser-posting` 技能撰写 X.com Thread/LinkedIn 文章。
|
|
15
|
+
- **通用内容创作者**:适配多平台格式,复用已有素材制作口播文案或短视频脚本。
|
|
16
|
+
- 使用 `spawn_subagent` 进行事实核查,确保每个声明可追溯。
|
|
17
|
+
- 通过 `task_submit_review` 提交初稿,附上:目标平台、受众分析、关键词、字数。
|
|
18
|
+
|
|
19
|
+
### 3. 审核(编辑)
|
|
20
|
+
- 审核标准:准确性、调性一致性、受众适配度、平台规范合规性。
|
|
21
|
+
- 使用 `spawn_subagent` 交叉验证声明与来源材料。
|
|
22
|
+
- 通过 `task_note` 留下结构化反馈:分类为"必须修改"、"建议"、"已通过"。
|
|
23
|
+
- 审核通过的内容标记为可发布。驳回的内容附上具体修改意见退回写手。
|
|
24
|
+
|
|
25
|
+
### 4. 发布(各平台运营者)
|
|
26
|
+
- **中文写手**:公众号排版(使用微信编辑器或 Markdown 转换),定时发布。
|
|
27
|
+
- **小红书运营**:使用 `xhs-posting` 技能发布图文笔记,配置正确的话题标签。
|
|
28
|
+
- **英文写手**:使用 `x-com-browser-posting` 技能发布 Thread 或推文。
|
|
29
|
+
- **通用内容创作者**:根据需求将内容分发到其他平台(抖音、B站等)。
|
|
30
|
+
- 在 `deliverable_create` 中记录发布链接和发布时间。
|
|
31
|
+
|
|
32
|
+
### 5. 数据复盘(编辑)
|
|
33
|
+
- 定期检查各平台数据(阅读量、互动率、转化等)。
|
|
34
|
+
- 将数据洞察反馈到下一轮内容日历规划中。
|
|
35
|
+
- 记录成功模式和失败教训到团队 NORMS 中。
|
|
36
|
+
|
|
37
|
+
## 质量标准
|
|
38
|
+
|
|
39
|
+
- **平台适配**:每个平台的内容风格必须适配该平台特点(微信长文 vs 小红书图文 vs X 短推文)。
|
|
40
|
+
- **可追溯声明**:每个事实性声明必须有可查证的来源。
|
|
41
|
+
- **一致性**:保持品牌调性一致,使用统一的术语和风格指南。
|
|
42
|
+
- **ROI 思维**:一个主题产出多平台版本,最大化内容投资回报。
|
|
43
|
+
|
|
44
|
+
## 沟通规范
|
|
45
|
+
|
|
46
|
+
- 编辑通过 `agent_send_message` 发布内容日历更新和选题通知。
|
|
47
|
+
- 写手在遇到平台适配问题时第一时间在团队内沟通。
|
|
48
|
+
- 所有内容成品通过 `deliverable_create` 登记,确保可追溯。
|
|
49
|
+
- 紧急发布需求使用 `notify_user` 通知编辑。
|
|
50
|
+
- 各平台数据表现定期通过 `task_note` 汇总。
|
|
@@ -2,52 +2,82 @@
|
|
|
2
2
|
"type": "team",
|
|
3
3
|
"name": "content-team",
|
|
4
4
|
"displayName": "Content Creation Team",
|
|
5
|
-
"version": "
|
|
6
|
-
"description": "A
|
|
5
|
+
"version": "3.0.0",
|
|
6
|
+
"description": "A multi-platform content creation team with specialized writers for Chinese and English markets. Editor-in-Chief plans the editorial calendar and reviews content; Chinese writer handles WeChat public accounts and Zhihu long-form articles; Little Red Book (Xiaohongshu) operator creates image-text notes and short videos; English writer produces X.com threads and LinkedIn articles; General content creator handles multi-platform adaptation and asset reuse. Each writer owns their platform domain. Designed for content operations, brand marketing, and cross-platform content strategies.",
|
|
7
7
|
"author": "Markus Team",
|
|
8
8
|
"category": "productivity",
|
|
9
|
-
"tags": ["content", "writing", "marketing", "
|
|
9
|
+
"tags": ["content", "writing", "marketing", "multi-platform", "social-media", "wechat", "xiaohongshu", "x.com", "linkedin", "zhihu"],
|
|
10
10
|
"icon": "edit",
|
|
11
|
+
"starterTasks": [
|
|
12
|
+
{
|
|
13
|
+
"title": "制定内容日历",
|
|
14
|
+
"description": "制定接下来一个月的选题规划,包含各平台发布节奏、内容主题、目标受众和关键时间节点。需要产出内容日历文档(Google Sheets 或 Markdown),供全体团队成员审阅。",
|
|
15
|
+
"priority": "high"
|
|
16
|
+
},
|
|
17
|
+
{
|
|
18
|
+
"title": "各平台账号配置与调研",
|
|
19
|
+
"description": "调研目标平台当前趋势和热门话题,确认各平台账号状态并完成配置。包括:微信公众号排版规范确认、小红书笔记格式适配、X.com Thread 模板准备、LinkedIn 文章风格调研。产出各平台内容风格指南。",
|
|
20
|
+
"priority": "medium"
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
"title": "第一篇内容策划与发布",
|
|
24
|
+
"description": "根据内容日历,选择第一个内容主题进行写作。各平台写手并行工作:中文内容适配公众号/知乎,小红书笔记同步制作,英文内容适配 X/LinkedIn。编辑审核后发布。",
|
|
25
|
+
"priority": "high"
|
|
26
|
+
}
|
|
27
|
+
],
|
|
11
28
|
"i18n": {
|
|
12
29
|
"zh-CN": {
|
|
13
|
-
"displayName": "
|
|
14
|
-
"description": "
|
|
30
|
+
"displayName": "自媒体内容团队",
|
|
31
|
+
"description": "多平台自媒体内容创作团队,配备覆盖中文和英文市场的专业创作者。编辑负责选题策划与内容审核;中文写手负责公众号和知乎长文;小红书运营制作图文笔记与短视频;英文写手生产 X.com 推文与 LinkedIn 文章;通用内容创作者负责多平台适配与素材复用。适用于内容运营、品牌营销和跨平台内容策略。",
|
|
15
32
|
"members": {
|
|
16
|
-
"Editor
|
|
17
|
-
"
|
|
18
|
-
"
|
|
19
|
-
"
|
|
33
|
+
"Editor": "编辑",
|
|
34
|
+
"Chinese Writer": "中文写手",
|
|
35
|
+
"Xiaohongshu Operator": "小红书运营",
|
|
36
|
+
"English Writer": "英文写手",
|
|
37
|
+
"General Content Creator": "通用内容创作者"
|
|
20
38
|
}
|
|
21
39
|
}
|
|
22
40
|
},
|
|
23
41
|
"team": {
|
|
24
42
|
"members": [
|
|
25
43
|
{
|
|
26
|
-
"name": "Editor
|
|
44
|
+
"name": "Editor",
|
|
27
45
|
"role": "manager",
|
|
28
46
|
"roleName": "project-manager",
|
|
29
47
|
"count": 1,
|
|
48
|
+
"description": "选题策划、内容审核、发布排期协调",
|
|
30
49
|
"skills": ["self-evolution"]
|
|
31
50
|
},
|
|
32
51
|
{
|
|
33
|
-
"name": "
|
|
52
|
+
"name": "Chinese Writer",
|
|
34
53
|
"role": "worker",
|
|
35
54
|
"roleName": "content-writer",
|
|
36
55
|
"count": 1,
|
|
56
|
+
"description": "微信公众号/知乎长文写作",
|
|
37
57
|
"skills": ["self-evolution"]
|
|
38
58
|
},
|
|
39
59
|
{
|
|
40
|
-
"name": "
|
|
60
|
+
"name": "Xiaohongshu Operator",
|
|
41
61
|
"role": "worker",
|
|
42
|
-
"roleName": "
|
|
62
|
+
"roleName": "content-writer",
|
|
43
63
|
"count": 1,
|
|
44
|
-
"
|
|
64
|
+
"description": "小红书图文/短视频创作与发布",
|
|
65
|
+
"skills": ["chrome-devtools", "xhs-posting", "self-evolution"]
|
|
45
66
|
},
|
|
46
67
|
{
|
|
47
|
-
"name": "
|
|
68
|
+
"name": "English Writer",
|
|
48
69
|
"role": "worker",
|
|
49
|
-
"roleName": "
|
|
70
|
+
"roleName": "content-writer",
|
|
71
|
+
"count": 1,
|
|
72
|
+
"description": "X.com/LinkedIn 英文推文与文章",
|
|
73
|
+
"skills": ["x-com-browser-posting", "self-evolution"]
|
|
74
|
+
},
|
|
75
|
+
{
|
|
76
|
+
"name": "General Content Creator",
|
|
77
|
+
"role": "worker",
|
|
78
|
+
"roleName": "content-writer",
|
|
50
79
|
"count": 1,
|
|
80
|
+
"description": "多平台适应、素材复用、抖音口播文案",
|
|
51
81
|
"skills": ["self-evolution"]
|
|
52
82
|
}
|
|
53
83
|
]
|
|
@@ -1,25 +1,30 @@
|
|
|
1
|
-
# Research Lab
|
|
1
|
+
# 调研研究团队 — Research Lab
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
结构化智库研究团队,专注于深度调研、竞品分析、行业报告和知识综合。
|
|
4
4
|
|
|
5
|
-
##
|
|
6
|
-
- **Research Lead** — Frames questions, assigns hypotheses, synthesizes consensus
|
|
7
|
-
- **3 Researchers** — Each investigates a different angle, then cross-examines peers' findings
|
|
5
|
+
## 团队结构
|
|
8
6
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
4. Lead synthesizes evidence into a conclusion with confidence levels
|
|
7
|
+
- **主任(Director)** — 制定调研方向、分配任务、审核综合产出
|
|
8
|
+
- **高级研究员(Senior Researcher)** — 深度调研、报告撰写、方法论证
|
|
9
|
+
- **助理研究员(Junior Researcher)** — 资料收集、初步分析、文献综述
|
|
10
|
+
- **协调秘书(Coordinator)** — 会议记录、进度跟踪、交付物整理
|
|
14
11
|
|
|
15
|
-
##
|
|
16
|
-
- **Root cause debugging**: Multiple hypotheses tested in parallel
|
|
17
|
-
- **Technology evaluation**: Each researcher champions a different option
|
|
18
|
-
- **Security audits**: Divide by attack surface, cross-verify findings
|
|
19
|
-
- **Architecture exploration**: Map a codebase from multiple perspectives
|
|
12
|
+
## 工作流程
|
|
20
13
|
|
|
21
|
-
|
|
22
|
-
|
|
14
|
+
1. **主任制定框架** — 明确研究问题、设定成功标准、分配调研方向
|
|
15
|
+
2. **并行调研** — 研究员在各自方向上独立调研,使用子代理进行深度挖掘
|
|
16
|
+
3. **交叉验证** — 研究员挑战彼此的发现,用对抗性检验提升结论可靠性
|
|
17
|
+
4. **综合产出** — 高级研究员综合各方成果撰写报告,主任审核后交付
|
|
23
18
|
|
|
24
|
-
##
|
|
25
|
-
|
|
19
|
+
## 核心方法论
|
|
20
|
+
|
|
21
|
+
- **竞争性假设检验**:每个问题从多个角度探索,避免锚定偏差
|
|
22
|
+
- **证据分级**:区分事实(直接支持)、推理(合理推断)和推测(未支持)
|
|
23
|
+
- **置信度评估**:每个结论附带置信度评级,当有新证据时更新
|
|
24
|
+
|
|
25
|
+
## 最适合
|
|
26
|
+
|
|
27
|
+
- 行业研究与竞品分析
|
|
28
|
+
- 技术趋势与架构评估
|
|
29
|
+
- 政策与市场分析报告
|
|
30
|
+
- 深度知识综合与白皮书撰写
|
|
@@ -1,88 +1,77 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
##
|
|
4
|
-
|
|
5
|
-
###
|
|
6
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
|
|
12
|
-
###
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
23
|
-
###
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
|
|
30
|
-
###
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
-
|
|
34
|
-
1.
|
|
35
|
-
2.
|
|
36
|
-
3.
|
|
37
|
-
4.
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
-
|
|
74
|
-
-
|
|
75
|
-
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
- Run `memory_search` at the start of new investigation threads to avoid redoing work.
|
|
80
|
-
- `memory_save` all durable insights: methods tried, dead ends, key citations, resolved disagreements, takeaways.
|
|
81
|
-
- Use consistent tagging (topic, project, phase, `hypothesis` when applicable) for fast retrieval.
|
|
82
|
-
|
|
83
|
-
## Communication
|
|
84
|
-
|
|
85
|
-
- **Share early, share raw**: Post intermediate findings to task notes. Don't wait for polished conclusions.
|
|
86
|
-
- **Cite your sources**: Every claim links to a file, URL, log line, or benchmark.
|
|
87
|
-
- **Disagree constructively**: "I found evidence that contradicts X because..." not "X is wrong."
|
|
88
|
-
- **Track confidence**: Use explicit levels (High/Medium/Low) and update as evidence changes.
|
|
1
|
+
# 调研研究团队 — 工作规范
|
|
2
|
+
|
|
3
|
+
## 方法论:框架 → 调研 → 验证 → 综合
|
|
4
|
+
|
|
5
|
+
### 阶段 1:框架(主任)
|
|
6
|
+
- 精确界定研究问题。模糊的问题产生模糊的答案。
|
|
7
|
+
- 设定**成功标准**:什么是"完成",什么证据足以证实或否定假设。
|
|
8
|
+
- 识别**竞争性假设**或**调研角度** — 为每个研究员分配不同的角度。
|
|
9
|
+
- 使用 `blockedBy` 设置依赖关系,确保后阶段在前置阶段完成后启动。
|
|
10
|
+
- 通过 `task_create` 创建调研任务,明确 `assigned_agent_id` 和 `reviewer_id`。
|
|
11
|
+
|
|
12
|
+
### 阶段 2:调研(研究员,并行)
|
|
13
|
+
- 每个研究员独立探索分配的角度。
|
|
14
|
+
- 使用 `spawn_subagent` 子代理进行深度挖掘(代码审查、文件分析、网络搜索),不丢失主调研上下文。
|
|
15
|
+
- 使用 `web_search` 和 `web_fetch` 进行外部研究 — 文档、论文、竞品对比。关键结论优先使用 `web_fetch` 验证原文,不依赖搜索摘要。
|
|
16
|
+
- 所有发现通过 `deliverable_create` 记录为带有证据的交付物:
|
|
17
|
+
- 代码片段、日志摘录、基准数据、文献引用
|
|
18
|
+
- 置信度(高/中/低)及理由
|
|
19
|
+
- 明确记录**没有找到什么**(负证据同样有价值)
|
|
20
|
+
- **不要锚定于第一个发现**。主动寻找反证。
|
|
21
|
+
- 开始调研前运行 `memory_search`,避免重复已有工作。
|
|
22
|
+
|
|
23
|
+
### 阶段 3:验证与交叉检验(全体研究员)
|
|
24
|
+
- 初步调研完成后,研究员通过 `agent_send_message` 互相审阅发现。
|
|
25
|
+
- 目标是对抗性的:每个研究员试图找出他人结论中的弱点。
|
|
26
|
+
- 追问:"要让这个结论被推翻,什么必须为真?"
|
|
27
|
+
- 倾向于提出具体质疑,而非简单盖章通过。未解决的分歧升级到主任,附上立场总结和证据。
|
|
28
|
+
- 基于收到的质疑更新自己的交付物。加强或撤回声明。
|
|
29
|
+
|
|
30
|
+
### 阶段 4:综合(高级研究员 + 主任)
|
|
31
|
+
- 高级研究员收集所有交付物和交叉检验结果。
|
|
32
|
+
- 使用 `spawn_subagent` 系统比较各研究员发现。
|
|
33
|
+
- 产出综合交付物(`deliverable_create`),包括:
|
|
34
|
+
1. **执行摘要** — 面向决策者:关键结论和置信度
|
|
35
|
+
2. **方法论** — 范围、参考来源、使用工具、局限性
|
|
36
|
+
3. **发现** — 按主题或问题组织,每个发现附带引证证据
|
|
37
|
+
4. **建议** — 可操作的后续步骤、明确假设、未解决问题
|
|
38
|
+
- 如未达成共识,综合报告应如实说明并建议进一步调研。
|
|
39
|
+
- 主任审阅并批准最终综合报告。
|
|
40
|
+
|
|
41
|
+
### 协调秘书的职责任务
|
|
42
|
+
- 使用 `task_note` 记录调研过程中的关键决策和讨论要点。
|
|
43
|
+
- 使用 `deliverable_create` 管理所有交付物版本,确保可追溯。
|
|
44
|
+
- 协调跨研究员的信息同步,避免重复工作。
|
|
45
|
+
- 在调研关键节点使用 `notify_user` 通知利益相关者进展。
|
|
46
|
+
- 最终交付物归档:确保格式规范、引用完整、附件齐全。
|
|
47
|
+
|
|
48
|
+
## 竞争性假设检验协议
|
|
49
|
+
|
|
50
|
+
对于模糊的调查(不确定根本原因、冲突来源、多个合理解释):
|
|
51
|
+
|
|
52
|
+
1. 每个研究员**独立**形成主要假设和至少一个备选假设,再进行深度协作。
|
|
53
|
+
2. 每个研究员先用自己的假设进行证据收集,不被他人结论锚定。
|
|
54
|
+
3. 使用 `memory_save` 记录假设,标签包含 `hypothesis` 加主题标签。
|
|
55
|
+
4. 只有在独立测试后才在验证阶段比较笔记。
|
|
56
|
+
|
|
57
|
+
## 证据标准
|
|
58
|
+
|
|
59
|
+
- **每个非平凡声明**必须引用具体来源(URL、文件路径、日志行或交付物引用)。
|
|
60
|
+
- 对主要结论分配**置信度**(高/中/低),明确说明什么会改变评级。
|
|
61
|
+
- 区分**事实**(直接支持)、**推理**(合理推断)和**推测**(未支持)。
|
|
62
|
+
- 无证据的发现是观点,不是研究。
|
|
63
|
+
- 负结果同样有价值 — "我调查了 X 但没有发现 Y 的证据"是有用的发现。
|
|
64
|
+
|
|
65
|
+
## 知识积累
|
|
66
|
+
|
|
67
|
+
- 开始新的调研线索前运行 `memory_search`,避免重复工作。
|
|
68
|
+
- 使用 `memory_save` 保存所有持久性洞察:试验过的方法、死胡同、关键引用、已解决分歧、经验教训。
|
|
69
|
+
- 使用一致的标签(主题、项目、阶段、`hypothesis`)以便快速检索。
|
|
70
|
+
|
|
71
|
+
## 沟通规范
|
|
72
|
+
|
|
73
|
+
- **尽早分享,分享原始数据**:将中期发现发布到任务备注。不要等到打磨成最终结论。
|
|
74
|
+
- **引用来源**:每个声明链接到文件、URL、日志行或基准测试。
|
|
75
|
+
- **建设性异议**:"我发现了与 X 矛盾的证据,因为..."而非"X 错了。"
|
|
76
|
+
- **跟踪置信度**:使用显式级别(高/中/低),随证据变化更新。
|
|
77
|
+
- 协调秘书确保关键沟通内容记录可追溯。
|