SuperAPI AI 工具集

agent-core-dev

智能体与模型

查看项目

更新于 10-16 01:19

技能介绍

用途:在 packages/agent-core-v2 中进行开发,包括新增或修改领域 Service、选择 LifecycleScope、配置依赖注入(DI)。该引擎基于 DI × Scope 架构,一切通过容器解析:服务声明身份、依赖与生命周期,容器决定构造、每作用域单例、顺序与销毁。技能自称自包含,规则不转发到仓库 docs,代码真实来源仍是 packages/agent-core-v2/src/。

主要能力与阶段:按 Orient → Design → Implement → Test → Verify 组织,各阶段互相独立阅读,末尾附各自红线。Design 阶段涉及选择作用域、跨作用域拆分领域、直调/事件/钩子调用风格、依赖方向,并含领域边界与作用域、持久化分层、边缘暴露等主题。Implement 阶段给出标准 Service 配方与 DI 构件,含接口+身份、构造注入、作用域注册、Disposable、eager 与 delayed、invokeFunction、createInstance、子作用域、循环重构,并涵盖配置、错误、标志、权限、遥测等主题。Test 阶段按接口解析被测系统,选择 TestInstantiationService 或 createScopedTestHost、共享桩、服务组与清理。Verify 阶段运行 lint:imports、typecheck、test 及提交前检查。

工作流:Align(将 agent-core 移植到 agent-core-v2,把 v1 类拆成语义单元并修正领域/作用域/Service/依赖后迁移逻辑与测试);Commit align(用一个 main 提交哈希与简短说明做三分类:aligned / partial / missing / not-applicable,并给最小修复建议);Server align(通过 server-v2 在 /api/v2 与 /api/v1 暴露 v2 领域,共享 @moonshot-ai/protocol 模式保持字节兼容,v1 专属行为放进 <domain>Legacy 边缘适配器)。

限制与红线:不得对构造器含 @IService 依赖的类使用 new,应注入 @IX 或用 accessor.get(IX);@IX 仅装饰构造参数;接口与实现都带 _serviceBrand,createDecorator 名全局唯一;父作用域不得依赖子作用域;禁止循环依赖;ServicesAccessor 仅在 invokeFunction 期间有效;未发布行为须经 registerFlagDefinition 与 IFlagService.enabled(id) 的 flag 控制;测试按接口解析 SUT,共享桩放 test/ 不放 src/;跨线分支用错误码而非 instanceof。资料未提供收费、价格、平台支持或效果数据。