SuperAPI AI 工具集

parallel-agent-contracts

编程与开发

查看项目

更新于 10-15 14:31

技能介绍

Parallel Agent Type Contracts 是一套面向并行代码实现智能体的类型契约规范,主要用途是防止多个并行智能体在同时实现代码时重复定义类型,从而避免类型冲突和代码库混乱。

主要能力体现在三项强制要求上。第一,验证命令:智能体在标记任务完成之前必须运行 npx tsc --noEmit 2>&1 | head -20,如果存在任何类型错误,必须先修复再完成。第二,创建前先搜索:在创建任何类型或接口之前,智能体必须先运行 grep -r "interface YourTypeName|type YourTypeName" src/ 检查该类型是否已存在,若已存在则直接导入,绝不重复定义已有类型。第三,规范类型映射表:规范提供了一份类型映射表,列出类型名、所属文件与导入来源,智能体提示词中应包含相关条目。映射表包含的类型有:NormalizedTool、ToolCall、ToolResult、ToolDefinition 均归属 src/sdk/agent.ts,从 './agent' 导入;Message、ContentBlock、TokenUsage 均归属 src/sdk/types.ts,从 './types' 导入;ProviderAdapter 归属 src/sdk/providers/index.ts,从 './providers' 导入;RiggClient 归属 src/sdk/client.ts,从 './client' 导入。

使用方式上,规范提供了一个提示词模板,用于生成实现智能体。模板包含任务描述、类型归属(列出规范映射表中的相关类型并注明不要重建)、创建新类型前的检查命令、完成前的验证命令,以及实际任务描述。

适用场景为需要启动多个并行智能体进行代码实现的开发流程,尤其是涉及共享类型定义的 TypeScript 项目。

限制方面,资料仅提供了上述规范内容与模板,未提供具体的安装命令、收费信息、平台支持范围或实际使用效果数据,这些内容暂未提供。