name: parallel-agent-contracts description: 并行代理类型合约 user-invocable: false
并行代理类型合约
在启动并行代理进行代码实现时,防止类型重复。
每个代理提示中必须包含
1. 验证命令(强制)
## 在标记完成之前
运行验证:
\`\`\`bash
npx tsc --noEmit 2>&1 | head -20
\`\`\`
如果存在任何类型错误,修复它们后再完成。
2. 创建前搜索
## 在创建任何类型/接口之前
首先检查它是否存在:
\`\`\`bash
grep -r "interface YourTypeName\|type YourTypeName" src/
\`\`\`
如果找到,导入它。切勿重复现有类型。
3. 规范类型映射
在代理提示中包含相关条目:
| 类型 | 所有者文件 | 导入来源 |
|---|---|---|
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' |
提示模板
当启动实现代理时:
# 任务:[描述]
## 类型所有权(请勿重新创建)
- [列出规范映射中的相关类型]
## 在创建新类型之前
运行:`grep -r "interface TypeName" src/` - 如果存在,导入它。
## 在标记完成之前
运行:`npx tsc --noEmit 2>&1 | head -20`
修复所有类型错误后再完成。
## 你的实现
[实际任务描述]
为什么这有效
- 类型检查器就是合约 - tsc自动捕获冲突
- Grep很快 - 1秒内检查类型是否存在
- 明确的所有权 - 没有关于类型位置的模糊性
- 快速失败 - 代理不能在类型损坏的情况下声称“完成”