V3 Core Implementation 是一个用于 claude-flow v3 的核心模块实现技能,目标是按照领域驱动设计(Domain-Driven Design,DDD)原则、整洁架构模式和现代 TypeScript 最佳实践,实现核心 TypeScript 模块,并配套较全面的测试覆盖。
用途与定位 该技能面向 claude-flow v3 的基础编码工作,帮助搭建清晰分层的核心代码结构,将不同职责分离到微内核、限界上下文、共享内核和应用层中。
主要能力与结构 技能给出的核心实现架构如下:
src/ ├── core/ │ ├── kernel/ # 微内核模式 │ │ ├── claude-flow-kernel.ts │ │ ├── domain-registry.ts │ │ └── plugin-loader.ts │ │ │ ├── domains/ # DDD 限界上下文 │ │ ├── task-management/ │ │ │ ├── entities/ │ │ │ ├── value-objects/ │ │ │ ├── services/ │ │ │ ├── repositories/ │ │ │ └── events/ │ │ │ │ │ ├── session-management/ │ │ ├── health-monitoring/ │ │ ├── lifecycle-management/ │ │ └── event-coordination/ │ │ │ ├── shared/ # 共享内核 │ │ ├── domain/ │ │ │ ├── entity.ts │ │ │ ├── value-object.ts │ │ │ ├── domain-event.ts │ │ │ └── aggregate-root.ts │ │ │ │ │ ├── infrastructure/ │ │ │ ├── event-bus.ts │ │ │ ├── dependency-container.ts │ │ │ └── logger.ts │ │ │ │ │ └── types/ │ │ ├── common.ts │ │ ├── errors.ts │ │ └── interfaces.ts │ │ │ └── application/ # 应用服务 │ ├── use-cases/ │ ├── commands/ │ ├── queries/ │ └── handlers/
基础领域类 技能提供 Entity、ValueObject、AggregateRoot 等基础领域类。Entity 负责标识与领域事件收集,ValueObject 采用冻结属性与相等性比较,AggregateRoot 在 Entity 基础上增加版本管理与事件应用能力,用于维护聚合一致性。
任务管理域实现 任务管理域包含 Task 实体、TaskId、TaskStatus、Priority 等值对象。Task 聚合根通过 create 和 reconstitute 创建,提供 assignTo、complete 等行为,并在状态变更时应用领域事件。TaskStatus 覆盖 pending、assigned、in_progress、completed、failed 状态;Priority 覆盖 low、medium、high、critical 等级,并提供数值化比较。
领域服务 TaskSchedulingService 提供任务优先级排序、调度判断和预计耗时计算等能力,示例中包含基于优先级的简单启发式估算。
仓储接口与实现 技能定义 ITaskRepository 接口,并提供基于 SQLite 的实现 SqliteTaskRepository,包含保存、按 ID 查询、按代理查询、按状态查询、查询待处理任务和删除等操作,并演示了从数据库行映射回领域对象的方式。
应用层 AssignTaskUseCase 展示应用层用例的典型流程:校验命令、加载聚合、执行业务规则、持久化变更、发布领域事件、标记事件已提交并返回结果。示例还包含错误处理和日志记录。
依赖注入 通过 DependencyContainer 使用 inversify 容器,将仓储、服务、用例和基础设施组件绑定为单例,提供 get 与 bind 方法。示例中绑定了 TaskRepository、AgentRepository、TaskSchedulingService、AssignTaskUseCase、Logger 和 DomainEventBus。
TypeScript 配置 技能给出较严格的 tsconfig.json 配置示例,包括 strict、exactOptionalPropertyTypes、noImplicitReturns、noFallthroughCasesInSwitch、noUncheckedIndexedAccess、noImplicitOverride 等选项,并开启装饰器与装饰器元数据支持,模块与模块解析使用 NodeNext。
使用方式 资料给出的快速开始方式为通过 Task 调用:
初始化核心实现
Task("Core foundation", "Set up DDD domain structure and base classes", "core-implementer")
领域实现(并行)
Task("Task domain", "Implement task management domain with entities and services", "core-implementer") Task("Session domain", "Implement session management domain", "core-implementer") Task("Health domain", "Implement health monitoring domain", "core-implementer")
适用场景 适合需要在 claude-flow v3 中建立 DDD 分层结构、实现核心 TypeScript 领域模块、组织依赖注入与用例编排的研发场景,尤其适合希望以整洁架构方式落地任务管理、会话管理、健康监控、生命周期管理和事件协调等限界上下文的项目。
限制 资料未提供该技能的收费、价格、平台支持范围、具体运行环境要求以及完整安装步骤,这些信息暂未提供。技能内容以示例代码和结构约定为主,是否可直接用于生产、是否需要额外依赖或数据库初始化脚本,资料中暂未说明。