用途:该工作流用于 ConvoAI iOS 仓库内的 iOS 需求实现、修改、修复、补全或交付,适用于 Scenes/ConvoAI、ConversationalAIAPI 及相邻 iOS 应用代码;不适用于纯闲聊或其他仓库的非 iOS 工作。触发输入如“帮我实现 xxx 需求”“帮我修改 xxx 功能”“修复这个 iOS 问题”。
主要能力:编码前先做规划——复述用户目标与验收标准、把需求拆成可独立关闭的功能项、识别依赖与执行顺序,并每次只保留一个活动功能项。多智能体执行仅在用户明确要求多智能体、委派或闭环开发/测试流程时启用:主线程充当控制器,派生一个开发者智能体和一个测试者智能体,循环执行实现→验证→修复,直到测试者返回 passed 或循环阻塞;否则保持单智能体模式并使用相同验证规则,但不派生开发者/测试者子智能体。
验证方式:逻辑/数据/API/存储/解析类任务以单元测试优先,开发者补充或更新 UT,测试者运行约定 UT 命令,UT 通过即算 passed;最终结项须展示完整 UT 状态,包括确切命令、是否重建或复用构建产物、可执行结果与具体用例结果。UI 任务默认不要求冒烟检查或模拟器走查,QA 负责 UI 验收,测试者只可做低成本自动检查且不得因缺少冒烟检查而阻塞。仅文档任务可用静态审查。
角色与仓库默认:开发者拥有生产代码与必要 demo 连线,逻辑任务需同步维护相关 UT;若仓库缺少合适应用自有 UT 目标,应创建或扩展最近的目标。测试者只做验证,不得修改生产文件。控制器负责拆解、排序、作用域与最终总结。默认代码范围含 iOS/Scenes/ConvoAI/ConvoAI/ConvoAI/Classes/ConversationalAIAPI、Main/Chat、Main/Chat/SIP、iOS/*Tests 及 Agent.xcodeproj/project.pbxproj。验证命令包括 git diff --name-only、rg、xcodebuild test,以及脚本 scripts/ios_build_for_testing.sh、scripts/ios_test_without_building.sh、scripts/ios_focused_test_fast.sh、scripts/ios_feature_validation.sh、scripts/preflight_ios_logic_ut.sh、scripts/run_ios_logic_ut.sh 等;逻辑任务默认优先使用工作区入口与最窄 -only-testing 命令。
限制与护栏:不得跳过需求分析与拆分;同一时间只能有一个活动功能项;不得实现后续计划项或隐藏额外范围;缺失端点、URL、凭证、资源、配置或产品决策时不得猜测,应在集成点留下 TODO;测试者不得改动生产文件或降低验收标准;不得仅凭开发者自报结项;逻辑任务未运行约定 UT 不得通过;纯编译检查不能替代 UT;UT 被环境阻塞时返回 blocked 而非 passed;不得默认对 UI 任务要求冒烟检查;未经用户明确要求不得推送、cherry-pick 或修改远程;保留用户改动与无关脏工作区。