SuperAPI AI 工具集

improvement

通用与其它

查看项目

更新于 10-16 07:13

技能介绍

用途:该技能指导如何用 TDD 与领域建模对 asc-swift(App Store Connect CLI)的既有功能做改进。若需新增功能,应改用 implement-feature 技能。

工作流:先阅读现有代码、理解当前行为并确定改进点;再为改进后的行为编写测试(Red,初始应失败,且不破坏既有测试);随后实现改进(Green,新测试通过且全部既有测试仍通过);若公开接口变化,更新 docs/features/<feature>/README.md,并在 [Unreleased] 下补一行 CHANGELOG,flags 变化时运行 make docs。

可改进类型:领域模型(如新增计算属性、改进日期格式化、封装领域规则);输出(表格对齐、JSON 字段、错误提示、markdown 格式、为模型补充 AffordanceProviding;面向智能体的命令 JSON 形如 {"data":[{...fields..., "affordances":{...cmds...}}]},应使用 formatter.formatAgentItems() 而非 formatItems);基础设施(OpenAPI 适配器错误信息、分页、字段映射);命令 UX(--help 文本、--filter/--sort、--limit 默认值、TUI)。

测试方式:领域用状态测试,输出用 OutputFormatterTests 与 AffordancesTests.swift,适配器用模拟 APIProvider,命令用参数解析测试或手动验证 TUI。遵循芝加哥学派 TDD,始终先写失败测试,测试命名反映用户预期。

限制:保持改动聚焦最小、不破坏既有行为、不写无关代码、不为小改动跳过测试、不在此技能中新增功能。运行 swift test 须全绿。具体命令与代码示例以资料为准。