parallel-agent-contracts

并行 Agent 类型契约

启动并行 Agent 实现代码时，避免重复定义类型。

每个 Agent 提示词中必须包含的内容

1. 验证命令（必需）

## Before Marking Complete
Run verification:
\`\`\`bash
npx tsc --noEmit 2>&1 | head -20
\`\`\`
If ANY type errors exist, fix them before completing.

2. 创建前先 grep

## Before Creating Any Type/Interface
First check if it exists:
\`\`\`bash
grep -r "interface YourTypeName\|type YourTypeName" src/
\`\`\`
If found, import it. NEVER duplicate existing types.

3. 规范类型映射

在 Agent 提示词中加入此映射表中的相关条目：

类型	所属文件	导入路径
NormalizedTool	src/sdk/agent.ts	'./agent'
ToolCall	src/sdk/agent.ts	'./agent'
ToolResult	src/sdk/agent.ts	'./agent'
ToolDefinition	src/sdk/agent.ts	'./agent'
Message	src/sdk/types.ts	'./types'
ContentBlock	src/sdk/types.ts	'./types'
TokenUsage	src/sdk/types.ts	'./types'
ProviderAdapter	src/sdk/providers/index.ts	'./providers'
RiggClient	src/sdk/client.ts	'./client'

提示词模板

启动实现 Agent 时：

# Task: [Description]

## Type Ownership (DO NOT recreate)
- [List relevant types from canonical map]

## Before Creating New Types
Run: `grep -r "interface TypeName" src/` - if exists, import it.

## Before Marking Complete
Run: `npx tsc --noEmit 2>&1 | head -20`
Fix all type errors before completing.

## Your Implementation
[Actual task description]

这样做的原因

1. 类型检查器就是契约——tsc 会自动捕获冲突
2. grep 速度快——检查类型是否存在只需 1 秒
3. 明确归属——类型的存放位置一目了然
4. 快速失败——类型有问题时，Agent 无法宣称“已完成”