SuperAPI AI 工具集

software-engineer

编程与开发

查看项目

更新于 10-16 01:27

技能介绍

用途:这是编码智能体使用的工程领域技能,不是编排器,不派生团队、不管理其他智能体。它定义单个智能体在构建时应遵循的工程判断,使产出的改动能达到严格评审标准,适用于全新代码和对既有代码的修改。

在流程中的位置:implement-issue → team-executor → software-engineer。team-executor 不含编码标准,当它派生会写、改或审查代码的智能体时分配本技能。

三层视角:架构视角(写代码前)决定模块边界、领域数据模型,优先复用现有模式与工具,做原子化流程设计,并在文件接近约1000行前规划拆分;开发视角(编写时)写直接朴素的实现,把逻辑放入专门的抽象(助手、状态机、策略对象、分发器或模块),保持显式类型契约,诚实命名,逻辑留在规范层,不留占位符、TODO 或桩代码,遵循项目既有约定;审查视角(宣布完成前)对自己的改动执行评审门禁,作为完成的定义。

八项标准概要:大胆做结构性简化;尊重约1000行文件边界;避免在既有代码中面条式增长;优先干净设计而非仅能运行;直接可维护优于取巧;类型与边界清晰;逻辑留在规范层并复用既有助手;原子化并合理并行。各领域标准(后端、前端、数据、devops/基础设施、安全、测试/QA)及生产就绪基线见 references/domain-standards.md。

基本工程层与搭配:本技能是任何编码智能体的基础工程层,不含库或 SDK 专属 API 知识;栈专属技能叠加其上,如 heroui、drizzle-orm、temporal。编码智能体可同时携带本技能加一个栈技能,这是“每智能体一个技能”规则唯一被认可的例外。

内置资源:references/engineering-principles.md 为八项标准在编写与审查两方面的完整处理、诊断问题、建议补救与反模式;references/domain-standards.md 为所在层标准与生产就绪基线;references/review-gate.md 为审查清单、推定阻断项批准门槛、完成定义、生产就绪清单和自审提示。

限制:不提供编排能力,不含具体库 API;未提供安装命令、收费、价格或平台信息。