SuperAPI AI 工具集

app-implement-feature

通用与其它

查看项目

更新于 10-16 05:46

技能介绍

用途:为 baguette(Swift CLI + WebSocket 服务,经私有 SimulatorKit 驱动 iOS 模拟器)新增功能时使用。它不是 SwiftUI 应用,没有 ViewModel 层,输入路径为同步返回 Bool 的调用,唯一具体适配器是 IndigoHIDInput;前端为手写 vanilla JS IIFE,无打包器,每个流一条 WebSocket。使用方式按四阶段流程:0)架构设计,需用户批准,产出 wire JSON 结构、CLI 子命令与参数、领域类型、适配器改动、前端改动及文件清单;跨层或触及 SimulatorKit/IndigoHID/AXPTranslator/spawn 时先停止设计。1)领域 TDD,先写失败测试,测试名用领域语言,值类型为 struct、方法挂在值上,Gesture 协议含 wireType、parse、execute,字段用 Field.requiredString 等提取器。2)基础设施 TDD,用 @Mockable 生成的 Mock 替换断言;若适配器包裹第三方 I/O,一次性调用则把后处理逻辑提到 Domain 的纯静态工厂,会话式 I/O 则引入以领域名词命名的 @Mockable 协作者(如 Subprocess),将编排器与仅约 30–50 行的 HostXxx 实现分离,后者不计覆盖率。3)接线:在 GestureRegistry 注册、加 CLI 子命令、如需前端则在 sim-input.js / sim-input-bridge.js 加处理并挂 IIFE,前端只做纯发送方,不承载 HID 码或领域逻辑。4)文档与 CHANGELOG:写 docs/features/<feature>/README.md(≤200 行)及必要的 design.md,更新 wire.md、serve.md、AGENTS.md 已知限制,CHANGELOG 在 Unreleased 下加一条 ≤300 字符,运行 make docs 与 make check-docs,不得手改生成文档。命名规则:抽象以领域角色命名,禁止 XxxPort/XxxService/XxxManager 及 Repository 后缀,仅聚合持久化可用复数集合名词。限制:TDD 不可跳过;私有 SimulatorKit 符号须在 resolveFunctions() 解析并记录日志,参数签名须对照经验证的开源桥接,签名猜测曾导致 backboardd 崩溃;多步序列须配对按下/抬起,不得残留按键或修饰键状态。具体价格、支持平台与更多功能细节暂未提供。