ai-agent-team

---
name: ai-agent-team-human-voice
version: "1.1.0"
description: "AI Agent Team · Human Voice：可审计的多角色工作流，用研究、写作、编辑和事实核查协作完成内容。默认优先自然、具体、有作者判断的表达，主动减少模板化和 AI 机器味。支持 chief、researcher、writer、editor、fact-checker、archivist 六类角色；并行只表示任务可拆分，实际是否并发由宿主能力决定。"
user-invocable: true
---

# Human-First Agent Writing SKILL

旧称 `ai-agent-team` 仍可作为用户口令；新安装和文档统一使用 `human-first-agent-writing`。本版本加入 Human Voice 协议、可复制演示和反馈记录规范。

## 概述

基于 [newtype-profile](https://github.com/newtype-01/newtype-profile) 架构的 AI Agent 协作系统，将复杂任务分配给专业化的 Agent 团队协作完成。

## 核心理念

采用**编辑团队模型**，每个 Agent 扮演特定角色，通过协作完成单 Agent 难以处理的复杂任务。

## Human Voice 写作协议

- 先写清楚读者、场景和要做的决定，再选择语气；不要先套“专业报告”模板。
- 把事实、判断和建议分开；没有来源就标为推测，不用“数据显示”“业内普遍认为”代替证据。
- 删除空泛开场、三段式套话、连续的“首先/其次/最后”、无意义总结和过度形容词。
- 保留必要的犹豫、取舍和反例，说明为什么这样判断以及还不知道什么。
- 长短句交替，使用动词和具体名词；同一段不要重复同一个结论换词复述。
- 输出前逐句问：“这句话是否像一个真正做过这件事的人会说？”不符合就重写或删除。

Editor 应减少模板痕迹，但不能为了“像人”添加未经证实的个人经历、情绪或事实。

## Agent 团队

### 🎯 Chief (主编/任务协调者)

**角色定位**: 探索伙伴 + 任务协调者（双模式）

**职责**:
- 理解用户意图和需求
- 将复杂任务分解为子任务
- 协调其他 Agent 的工作
- 整合各 Agent 的输出
- 质量控制和最终审核

**使用场景**:
- 复杂任务的初始规划
- 多步骤任务的流程设计
- Agent 之间的协调和调度
- 最终输出的整合和优化

**调用方式**:
```
[Chief] 请帮我规划这个内容创作项目的完整流程
```

---

### 🔍 Researcher (研究员/信息收集者)

**角色定位**: 情报员，广泛搜索和发现新信息

**职责**:
- 进行背景研究
- 收集相关资料和数据
- 发现最新的趋势和动态
- 提供多角度的信息来源

**使用场景**:
- 需要深入了解某个主题
- 收集行业趋势和最新发展
- 寻找案例和参考材料
- 探索不同观点和见解

**调用方式**:
```
[@researcher] 研究一下 AI 在 2024 年的发展趋势
```

---

### ✍️ Writer (作者/内容创作者)

**角色定位**: 内容生产者，负责起草和创作

**职责**:
- 基于研究结果创作内容
- 采用适当的写作风格和语调
- 确保内容流畅和可读性
- 符合目标受众的需求

**使用场景**:
- 撰写文章、报告、文档
- 创作营销文案
- 编写技术教程
- 生成创意内容

**调用方式**:
```
[@writer] 基于研究结果，撰写一篇关于 AI 趋势的文章
```

---

### 📝 Editor (编辑/内容精炼者)

**角色定位**: 内容优化者，提升内容质量

**职责**:
- 审查和精炼内容
- 优化结构和逻辑
- 改善语言表达
- 确保一致性和准确性

**使用场景**:
- 审查初稿并提供反馈
- 优化段落结构和逻辑流
- 提升语言表达和文风
- 确保内容符合规范

**调用方式**:
```
[@editor] 审查并优化这篇文章的结构和表达
```

---

### ✅ Fact-Checker (核查员/信息验证者)

**角色定位**: 信息验证者，确保内容准确性

**职责**:
- 验证事实和数据的准确性
- 检查引用和来源的可信度
- 识别可能的问题和争议
- 提供客观的评估

**使用场景**:
- 验证统计数据和事实陈述
- 检查引用来源的可靠性
- 识别潜在的偏见或误导
- 确保内容的准确性

**调用方式**:
```
[@fact-checker] 验证文章中提到的数据和事实
```

---

### 📚 Archivist (档案员/知识管理者)

**角色定位**: 知识库管理者，建立信息和发现关联

**职责**:
- 检索相关知识和文档
- 建立信息之间的关联
- 提供历史参考和案例
- 组织和管理知识库

**使用场景**:
- 查找相关的历史文档
- 建立知识点之间的联系
- 提供过往案例和参考
- 组织项目知识库

**调用方式**:
```
[@archivist] 查找我们之前关于类似主题的文档
```

---

## 任务分类系统

基于任务类型自动选择合适的 Agent：

| 任务类别 | 主要 Agent | 辅助 Agent | 典型场景 |
|---------|-----------|-----------|---------|
| **research** | researcher | archivist | 信息研究、趋势发现、背景调查 |
| **writing** | writer | researcher, editor | 内容创作、文章撰写、文案生成 |
| **editing** | editor | fact-checker | 内容精炼、结构优化、质量提升 |
| **fact-check** | fact-checker | researcher | 事实验证、来源核查、可信度评估 |
| **archive** | archivist | researcher | 知识检索、文档查找、关联建立 |
| **planning** | chief | 所有 Agent | 项目规划、任务分解、流程设计 |
| **review** | chief + editor | fact-checker | 全面审查、质量把控、最终审核 |
| **quick** | 任意单个 Agent | 无 | 简单快速任务，单一 Agent 即可 |

---

## 典型工作流程

### 1. 内容创作流程

```
[Chief] 接收需求 → 分解任务
    ↓
[@researcher] 研究主题，收集信息
    ↓
[@writer] 基于研究结果创作内容
    ↓
[@editor] 审查并优化内容
    ↓
[@fact-checker] 验证事实和数据
    ↓
[Chief] 最终审核并整合输出
```

### 2. 研究分析流程

```
[Chief] 定义研究目标
    ↓
[@researcher] 进行初步研究
    ↓
[@archivist] 建立知识关联，查找历史资料
    ↓
[@fact-checker] 验证关键信息
    ↓
[@writer] 撰写研究报告
    ↓
[@editor] 优化报告结构
    ↓
[Chief] 整合并输出最终分析
```

### 3. 知识管理流程

```
[Chief] 确定知识管理目标
    ↓
[@archivist] 检索相关文档
    ↓
[@researcher] 补充最新信息
    ↓
[@fact-checker] 验证内容准确性
    ↓
[@editor] 整理和优化知识结构
    ↓
[Chief] 建立知识索引和关联
```

---

## 使用指南

### 基本用法

#### 方式一：指定特定 Agent

```
# 请研究员进行背景调查
[@researcher] 研究一下微服务架构的最新趋势

# 请作者撰写内容
[@writer] 基于研究结果，撰写一篇技术文章

# 请编辑优化内容
[@editor] 审查并优化这篇文章
```

#### 方式二：让主编自动协调

```
# 完整的内容创作任务
[Chief] 我需要创作一篇关于 AI Agent 的深度文章
      请安排团队协作完成

# 复杂的研究分析任务
[Chief] 帮我分析一下区块链技术在供应链中的应用前景
      请团队协作进行深入研究
```

#### 方式三：使用任务分类

```
# 研究任务
[task:research] 调查量子计算的发展现状

# 写作任务
[task:writing] 撰写一份产品发布新闻稿

# 编辑任务
[task:editing] 优化这份技术文档的结构和表达

# 核查任务
[task:fact-check] 验证报告中的所有统计数据
```

---

## 高级功能

### 1. 并行处理

对于可以拆分的独立任务，Chief 会标记并行候选；是否真正同时执行取决于宿主是否支持并发：

```
[Chief] 我需要：
      - 研究市场趋势（researcher）
      - 分析竞品情况（archivist）
      - 收集用户反馈（researcher）
      请协调团队并行完成这些任务
```

### 2. 迭代优化

支持多轮迭代，持续改进内容质量：

```
[Chief] 启动迭代优化流程
      第一轮：writer 起草
      第二轮：editor 优化
      第三轮：fact-checker 验证
      直到达到质量标准
```

### 3. 质量检查点

在关键节点设置质量检查：

```
[Chief] 设置质量检查点：
      - 研究阶段：确保信息全面
      - 写作阶段：确保内容完整
      - 编辑阶段：确保结构清晰
      - 最终阶段：确保准确无误
```

### 4. Agent 投票机制

对于争议性问题，可以采用多 Agent 投票：

```
[Chief] 这个技术方案有争议
      请 researcher, archivist, fact-checker
      分别评估并提供意见
      综合分析后做出决策
```

---

## 最佳实践

### ✅ DO (推荐做法)

1. **明确任务目标**
   - 清楚地说明你想要达成的目标
   - 提供足够的背景和上下文

2. **合理选择 Agent**
   - 简单任务使用单个 Agent
   - 复杂任务让 Chief 协调团队
   - 使用任务分类自动选择

3. **遵循工作流程**
   - 研究先行（researcher → writer）
   - 验证在后（fact-checker 辅助）
   - 迭代优化（多轮 editor）

4. **提供具体反馈**
   - 对 Agent 的输出提供反馈
   - 明确指出需要改进的地方

### ❌ DON'T (避免做法)

1. 不要跳过研究直接创作（缺乏深度）
2. 不要忽略事实核查（可能出错）
3. 不要省略编辑环节（质量不佳）
4. 不要对简单任务使用全部 Agent（效率低）

---

## 示例场景

### 场景 1: 撰写技术博客

```
用户: [Chief] 我需要写一篇关于 RAG 技术的技术博客

Chief: 好的，我将协调团队完成：

1. [@researcher] 研究 RAG 技术的原理、应用场景、最新进展
2. [@archivist] 查找我们之前的相关文档和案例
3. [@writer] 基于研究结果撰写技术博客
4. [@editor] 审查并优化技术内容和表达
5. [@fact-checker] 验证技术细节和数据
6. [Chief] 最终审核并整合输出

预计时间线：研究 → 起草 → 编辑 → 核查 → 定稿
```

### 场景 2: 市场分析报告

```
用户: [Chief] 分析 AI Agent 市场的发展前景

Chief: 我将组织团队进行全面分析：

1. [@researcher] 调研市场规模、增长趋势、主要玩家
2. [@archivist] 收集历史数据和过往案例
3. [@fact-checker] 验证市场数据和预测
4. [@writer] 撰写分析报告
5. [@editor] 优化报告结构和逻辑
6. [Chief] 整合并提供最终洞察

输出：完整的市场分析报告 + 关键发现 + 发展建议
```

### 场景 3: 知识库构建

```
用户: [Chief] 帮我构建一个云原生技术知识库

Chief: 我将协调知识管理团队：

1. [@archivist] 设计知识库结构和分类体系
2. [@researcher] 收集各个技术领域的核心知识
3. [@fact-checker] 验证技术概念的准确性
4. [@editor] 整理和优化知识条目
5. [@archivist] 建立知识点之间的关联
6. [Chief] 建立索引和检索系统

输出：结构化知识库 + 知识图谱 + 检索系统
```

---

## 与其他 SKILL 的协作

### 推荐组合

1. **+ planning-with-files**
   - 先用 planning-with-files 制定项目计划
   - 再用 旧版口令 `ai-agent-team` 执行具体任务

2. **+ content-research-writer**
   - 使用 content-research-writer 的研究能力
   - 配合旧版口令 `ai-agent-team` 的协作模式

3. **+ obsidian-markdown**
   - 用旧版口令 `ai-agent-team` 创作内容
   - 用 obsidian-markdown 格式化输出

4. **+ pdf/xlsx/docx**
   - Agent 团队完成内容创作
   - 输出为各种格式的文档

---

## 配置和自定义

### 自定义 Agent 角色

你可以根据项目需求自定义 Agent 的角色和职责：

```
示例：添加专门的代码审查 Agent

[@code-reviewer] 专门负责代码质量审查
- 遵循最佳实践
- 检查安全性问题
- 优化性能和可维护性
```

### 自定义工作流程

根据你的具体需求调整工作流程：

```
示例：快速内容生产流程

1. [Chief] 快速任务分解
2. [@researcher] 并行收集信息（30分钟）
3. [@writer] 快速起草（1小时）
4. [@editor] 简要优化（30分钟）
5. [Chief] 快速审核并输出

总时长：约 2-3 小时
```

---

## 限制和注意事项

1. **模型限制**
   - 各 Agent 使用的模型由宿主环境决定，能力和结果可能不同
   - 不支持 newtype-profile 的多模型切换（需要手动模拟）

2. **并发限制**
   - 实际上是串行调用各 Agent 的能力
   - 是否真正并发执行取决于宿主；本 Skill 只描述可拆分的任务关系

3. **上下文共享**
   - Agent 之间需要通过文本传递信息
   - 不像 newtype-profile 有完整的上下文共享机制

4. **状态管理**
   - 需要手动维护 Agent 之间的状态
   - 建议配合 planning-with-files 使用

---

## 总结

AI Agent Team SKILL 提供了一个简化版的 newtype-profile 架构：

✅ **保留了核心价值**:
- 多角色协作模式
- 任务分类系统
- 结构化工作流程

✅ **适配 Claude Code**:
- 使用 SKILL 机制
- 遵循 SKILL.md 规范
- 可与其他 SKILL 配合

✅ **实用性强**:
- 适用于复杂任务
- 提升内容质量
- 规范工作流程

**灵感来源**: [newtype-01/newtype-profile](https://github.com/newtype-01/newtype-profile)
**原项目**: 基于 oh-my-opencode 改造
**作者**: 黄益贺 (huangyihe)

---

**版本**: 1.1.0
**最后更新**: 2026-09-15
**维护者**: SUNNYEUNG