SuperAPI AI 工具集

core-coder

编程与开发

查看项目

更新于 10-16 04:02

技能介绍

用途

Core Coder 是一个实现专家技能,以资深软件工程师的角色,专注于编写整洁、可维护、高效的代码,遵循最佳实践与设计模式。

适用场景包括:

  • 根据规格实现新功能
  • 重构既有代码以提升可维护性
  • 设计与实现 API
  • 优化热路径的性能
  • 编写带完善错误处理的生产级代码

前提条件

  • 明确的需求或规格
  • 对项目架构的理解
  • 可访问测试框架以进行 TDD
  • 与 researcher 协作获取上下文

核心概念

代码质量标准

资料给出的示例模式包括:清晰的命名、单一职责、依赖注入、错误处理(捕获后记录日志并抛出用户友好的错误)。

设计模式

  • SOLID 原则:设计类时始终应用
  • DRY:通过抽象消除重复
  • KISS:保持实现简单专注
  • YAGNI:在需要之前不添加功能

性能考量

  • 优化热路径:对昂贵操作进行记忆化(memoize)
  • 使用高效数据结构:例如 Map 做查找
  • 批处理操作:Promise.all
  • 懒加载:动态 import 重型模块

实现模式

  1. 理解需求:彻底审查规格、编码前澄清歧义、考虑边界情况与错误场景
  2. 先设计:规划架构、定义接口与契约、考虑可扩展性
  3. 测试驱动开发:先写测试,再实现
  4. 增量实现:从核心功能开始、增量添加特性、持续重构

配置与风格

给出了一种文件组织方式:按模块划分目录,包含 service、controller、repository、types、test 等文件。TypeScript/JavaScript 风格示例包括现代语法、类型定义、错误边界类(ServiceError)。

使用方式

通过 Task 派生 coder agent 进行实现:

Task("Coder agent", "Implement [feature] following TDD. Coordinate via memory.", "coder")

通过内存/MCP 工具存储实现状态:

{
  action: "store",
  key: "swarm/coder/status",
  namespace: "coordination",
  value: JSON.stringify({ agent: "coder", status: "implementing", feature: "[feature]" })
}

技能还给出执行清单:审查规格并澄清歧义、在内存中检查 researcher 的发现、先写失败测试(TDD)、实现最小代码通过测试、重构并保持测试绿色、在内存中更新实现状态、运行 lint 与验证、在内存中记录假设与决策、向 tester 交接。

错误处理

资料提供对照表:

  • ValidationError:无效输入数据 → 返回 400 与消息
  • NotFoundError:资源不存在 → 返回 404
  • AuthorizationError:权限不足 → 返回 403
  • ServiceError:内部故障 → 记录日志,返回 500

成功指标

  • 代码覆盖率 >80%
  • Lint 错误:0
  • 类型错误:0
  • 全部测试通过
  • 实现状态存储在内存中

协作与集成

相关技能包括 core-researcher(提供上下文与发现)、core-tester(验证实现)、core-reviewer(审查代码质量)、core-planner(提供任务拆分)。协作要求:与 researcher 协调上下文、遵循 planner 的任务拆分、向 tester 清晰交接、在内存中记录假设与决策、不确定时请求审查、通过 MCP 内存工具共享所有实现决策。

集成点包括通过 MCP 工具上报实现状态、共享代码决策(模式、依赖、API 端点)、检查依赖等。

限制

资料未提供该技能的具体收费、价格、支持平台、安装命令或独立运行方式;其运行依赖 Task agent 调度、内存/MCP 协调工具及项目自身的测试框架。