Multi-Thread Dialogue / 多线程对话架构

多线程对话架构，让 AI 能够同时处理多个任务，支持打断和任务监控。

Multi-thread dialogue architecture enabling AI to handle multiple tasks simultaneously with interruption support.

⚠️ 实现方式 / Implementation

本 Skill 主要提供文档和辅助工具。核心逻辑通过 AGENTS.md 实现。

This Skill primarily provides documentation and auxiliary tools. Core logic is implemented through AGENTS.md.

原因 / Reason：AGENTS.md 定义了我的行为规则，可以直接实现：

• 任务类型判断 + 触发规则
• 子代理 spawn + 模型选择
• 状态处理（DONE/DONE_WITH_CONCERNS/NEEDS_CONTEXT/BLOCKED）
• 打断机制 + 状态监控

AGENTS.md defines my behavior rules and directly implements:

• Task type judgment + trigger rules
• Sub-agent spawn + model selection
• State handling (DONE/DONE_WITH_CONCERNS/NEEDS_CONTEXT/BLOCKED)
• Interruption mechanism + state monitoring

无需额外的 Hook。No additional hooks needed.

功能特性 / Features

1. 智能任务分流 / Intelligent Task Routing

2. 模型选择 / Model Selection

3. 状态处理 / State Handling

4. 质量保障（可选）/ Quality Assurance (Optional)

两阶段审查机制 / Two-phase review mechanism:

[实现子代理] → [Spec 审查] → [代码质量审查] → [展示结果]
[Implement Sub-agent] → [Spec Review] → [Code Quality Review] → [Show Result]

5. 交互模式 / Interaction Mode

• 任务编号 / Task ID：递增编号 (1, 2, 3...) / Incremental numbering
• 即时介入 / Immediate intervention：子代理暂停等你操作 / Sub-agent pauses for your input
• 阶段决策 / Phase decision：完成后汇总让你选 / Summarize after completion for your choice
• 打断 / Interruption：说"停"或"打断"停止最近任务 / Say "stop" or "interrupt" to halt recent task

6. 监控提醒 / Monitoring & Alerts

• 30分钟超时自动提醒 / 30-min timeout auto-alert
• 1天超时自动删除释放资源 / 1-day timeout auto-delete to free resources
• 用户用任务号指定回复 / User can reply by task number

安装 / Installation

1. 安装 Skill / Install Skill

npx skills add multi-thread-dialogue
# 或 / or
npx skills add multi-thread-dialogue -g

2. 配置 AGENTS.md（关键步骤）/ Configure AGENTS.md (Key Step)

打开你的 AGENTS.md 文件，确保包含"Multi-Thread Dialogue Mode"章节。如果没有，手动添加：

Open your AGENTS.md, ensure it contains "Multi-Thread Dialogue Mode" section. Add manually if missing:

## 🧵 Multi-Thread Dialogue Mode

### 触发规则 / Trigger Rules
| 条件 / Condition | 阈值 / Threshold | 行为 / Behavior |
|------|------|------|
| 简单任务 / Simple task | ≤3 tool calls | 前台处理 / Foreground |
| 长任务 / Long task | >3 tool calls | spawn 子代理 / Spawn sub-agent |
| 上下文膨胀 / Context bloat | >3000 tokens | spawn 子代理 / Spawn sub-agent |
| 独立任务 / Independent tasks | 多步骤 / Multi-step | 可并行 / Parallel |

### 模型选择 / Model Selection
| 复杂度 | 模型 | 示例 |
|--------|------|------|
| 机械 | mini/fast | 简单重构 |
| 标准 | 继承父模型 | 功能实现 |
| 判断 | 最强模型 | 架构/审查 |

### 状态处理 / State Handling
- DONE: 进入审查或展示结果
- DONE_WITH_CONCERNS: 读取疑虑再决定
- NEEDS_CONTEXT: 提供信息后重新 dispatch
- BLOCKED: 评估原因处理

### 交互 / Interaction
- 任务编号：每个子代理递增编号
- 打断："停"或"打断"停止最近任务
- 指定回复："X号任务..."精准定位

### 监控 / Monitoring
- 等待超30分钟提醒
- 1天超时删除释放资源

3. 创建任务状态文件 / Create Task State File

mkdir -p memory
echo '{"nextTaskId": 1, "tasks": []}' > memory/multi-thread-tasks.json

使用方法 / Usage

Spawn 子代理时使用 Prompt 模板 / Prompt Template for Spawning Sub-agents

[任务背景 / Task Background]
你在处理 [项目/领域] 的 [具体任务]。
You are handling [specific task] for [project/domain].

[目标 / Goals]
1. [具体目标1 / Specific goal 1]
2. [具体目标2 / Specific goal 2]

[约束 / Constraints]
- 关注 / Focus on：[具体范围 / Specific scope]
- 优先 / Priority：[重要事项 / Important item]
- 跳过 / Skip：[不需要的 / Not needed]

[输出格式 / Output Format]
返回 / Return：[具体格式 / Specific format]

[完成条件 / Completion Criteria]
完成当 / Complete when：[具体判定标准 / Specific criteria]

状态标记 / State Markers

子代理完成任务时，在返回结果前明确标记状态：

When sub-agent completes, clearly mark state before returning:

• DONE - 任务完成 / Task complete
• DONE_WITH_CONCERNS: [疑虑内容] - 完成但有疑虑 / Complete but has concerns
• NEEDS_CONTEXT: [缺失信息] - 需要更多信息 / Need more info
• BLOCKED: [阻塞原因] - 无法完成 / Cannot complete

查看任务状态 / Check Task Status

你：任务列表 / 有哪些在跑
→ 显示所有活跃子代理
→ Show all active sub-agents

配置参数 / Configuration Parameters

文件结构 / File Structure

multi-thread-dialogue/
├── SKILL.md                    # 本文件 / This file
├── _meta.json                  # 元数据 / Metadata
├── skill.yaml                  # Skill 配置 / Skill config
├── README.md                   # 英文版说明 / English version
└── docs/
    └── multi-thread-dialogue-plan.md  # 完整方案文档 / Complete plan doc

类似技能 / Similar Skills

• skill-creator: 技能创建工具 / Skill creation tool
• subagent-creator: 子代理创建器 / Sub-agent creator (tech-leads-club)
• codex-subagent: Codex 子代理 / Codex sub-agent (am-will)
• superpowers: Subagent 驱动开发 / Subagent-driven development (obra)