并行代理类型合约管理Skill parallel-agent-contracts

这个技能专注于在并行代理代码实现中管理类型合约,通过自动化工具如TypeScript编译器(tsc)和grep命令,确保代码类型的一致性,防止重复定义,提高开发效率。关键词:类型管理、代码验证、并行代理、软件开发、自动化工具、类型安全、代码质量、快速失败机制。

架构设计 0 次安装 0 次浏览 更新于 3/14/2026

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`
修复所有类型错误后再完成。

## 你的实现
[实际任务描述]

为什么这有效

  1. 类型检查器就是合约 - tsc自动捕获冲突
  2. Grep很快 - 1秒内检查类型是否存在
  3. 明确的所有权 - 没有关于类型位置的模糊性
  4. 快速失败 - 代理不能在类型损坏的情况下声称“完成”