SuperAPI AI 工具集

scaffold

编程与开发

查看项目

更新于 11-06 09:09

技能介绍

用途 scaffold 是 easy-claude 技能集中的一个架构技能,目标是在功能实现之前,为项目建立可复用的架构基础设施与“黄金路径”示例,而不是直接编写功能代码。它按项目已选定的架构范式(语言、框架约定与实际需求)生成适用的抽象与基础设施,并保持 $feature-implement 在验证门禁通过前处于阻塞状态。

主要能力

  1. 激活守卫:执行前必须满足工作流为 workflow-greenfield-init 或 workflow-big-feature;否则整个技能跳过并标记完成。
  2. 现有脚手架自检:通过 grep 检索抽象基类、泛型接口、基础设施抽象(IRepository/IUnitOfWork 等)、工具层、前端基础组件、DI/IoC 注册等,按计划边界评估现有基础是否可复用,记录已复用、缺失或不适用项。只有全部适用需求都被合适基础覆盖时才跳过。
  3. 清单生成与确认:读取计划中的架构决策、技术栈与领域模型,生成后端和/或前端脚手架清单,并映射每条架构决策;通过提问工具向用户确认清单后再生成代码。
  4. 后端分类:领域层(实体基类、值对象基类、领域事件接口)、应用层(命令/查询处理抽象、验证结果、基 DTO、分页、操作结果)、基础设施层(泛型仓储、工作单元、消息/事件总线、外部服务抽象、数据库上下文、DI 注册)、横切关注点(当前用户上下文、可测试时间提供者、异常层次、错误处理中间件、强类型配置)。
  5. 前端分类:核心架构候选(基组件、表单抽象、列表抽象)、状态与 API 候选、共享工具候选,以及 UI 基础(设计令牌、布局与尺寸适配、共享 UI 组件、UI 约定文档);无 UI 的项目整体跳过 UI 部分。
  6. 黄金路径示例:为选定的可复用模式生成小规模、可编译的示例,置于隔离的 examples/ 目录,文件名带 .example. 后缀,CI 编译/检查但从生产构建排除,头部带固定说明注释,示例中只使用占位符,不含真实密钥或端点。
  7. 测试契约解析:在交接前解析单元、集成/系统、E2E 各层级,记录运行器、全量与聚焦命令、零匹配失败行为、CI 门禁、Windows/macOS/Linux 简单入口;无证据的 E2E 记为 N/A。
  8. 验证门禁与后续衔接:验证构建、架构、可测试性与验证门禁,之后依次调用 $linter-setup、$harness-setup,并用提问工具完成交接。

使用方式 在 greenfield-init 或 big-feature 工作流中完成第二次 $plan(含 --mode=review)之后、$feature-implement 之前调用。技能按声明顺序执行步骤,每一步更新待办跟踪并附证据或跳过理由;用户显式请求技能时执行其协议。若涉及 AI 表面(模型调用、提示词、智能体、工具/MCP、检索或评估),需读取并应用 ai-feature-framing-gate.md。在 Codex 环境中通过 $skill-name 加载对应 SKILL.md 执行,无需单独的 Skill 工具。

适用场景 新建服务或模块需要自有基础架构且尚不存在基础时;大型功能开发在编码前需要统一抽象与示例时;需要在项目初始化阶段建立质量门禁与测试执行契约时。

限制 当现有合适基础已覆盖计划边界,或当前工作流不是上述两种时,技能会跳过。技能强调以证据解析适用性与完成度,不猜测缺失的运行器、命令或模式;不虚构 E2E 覆盖;清单中的分类名称仅为示例,需按项目实际适配。交接的具体流程细节在源资料中被截断,部分内容暂未提供。