附录 A：类型定义速查
本附录提供核心类型的快速索引。详细说明和设计原理请参考对应章节。
注意：
Task、TaskStatus、AgentType等核心类型的完整说明见 第二章：核心概念。
A.1 基础枚举
type TaskStatus =
| 'pending' | 'scheduled' | 'in_progress'
| 'blocked' | 'waiting' | 'verify' | 'accept'
| 'completed' | 'failed' | 'retry_queue';
type AgentType =
| 'planner' | 'coder' | 'tester'
| 'reviewer' | 'researcher' | 'executor';
type PhaseType = 'tdd' | 'develop' | 'verify' | 'accept';
type QualityLevel = 'strict' | 'balanced' | 'fast';
type ExecutionMode = 'interactive' | 'semi-auto' | 'full-auto';
type MeetingType = 'information' | 'decision' | 'approval' | 'dependency';
type ApprovalType = 'plan' | 'merge' | 'deploy' | 'meeting';
A.2 数据结构索引
| 类型 | 定义位置 | 说明 |
|---|---|---|
Task | 2.1 任务 | 任务定义 |
Meeting | 2.5 Meeting | 阻塞记录 |
Approval | 4.7 审批管理 | 审批记录 |
SubagentTask | 5.3 AgentRunner | Agent 执行配置 |
AgentResult | 5.2 BaseAgent | Agent 执行结果 |
QualityReport | 9.10 质量报告 | 质量验证报告 |
GlobalState | 6.3 StateManager | 全局状态 |
TaskInput | 4.5 TaskPlanner | 任务输入 |
ExecutionResult | 4.1 Executor | 执行结果 |
QualityConfig | 9.1 质量门禁总览 | 质量配置 |
A.3 便捷类型
// 门禁结果
interface GateResult { status: 'pass' | 'fail'; details?: string }
// 覆盖率结果
interface CoverageResult extends GateResult {
line: number; function: number; branch: number; threshold: number;
}
// 测试结果
interface TestResult extends GateResult {
total: number; passed: number; failed: number; skipped: number;
}
// 上下文
interface AgentContext {
taskId: string; task: Task; phase: PhaseType;
accumulatedContext: string; projectContext: ProjectContext;
}
// 问题
interface Question {
id: string; text: string;
type: 'text' | 'choice' | 'boolean';
options?: string[]; required: boolean;
}