SuperAPI AI 工具集

guide

通用与其它

查看项目

更新于 10-16 09:46

技能介绍

用途:Guide 面向 testany-eng 主流程,回答三件事——当前项目走到哪一步、哪些关键基线已具备或缺失、下一步最适合运行哪个 skill/workflow 及原因。它是导航器而非产出器,不直接撰写 BRD/PRD/HLD/LLD/Test/Runbook,也不替代 reviewer 做准出判断,只做状态识别与路由建议。

主要能力:扫描仓库与元数据,归一化 artifact 状态为 missing、draft、in_review、approved、unknown,按证据优先级(TRACEABILITY-METADATA、文档内状态字段、准出证书、审查报告、标题或文件名关键词)取证,并据此推荐 1 至 3 条最小下一步。覆盖正式新功能主流程(BRD 到 Runbook)、可选 UI 设计与 Prototype 分支、实现门禁 Implementation Candidate 到 Code Review、可选 Testany Automation Landing 分支、横切 Guardrails,以及可选协作分支 Delivery Secretary。

使用方式:先识别用户要的是正式新功能流程还是已有系统有限变更,再按 workflow-map.yaml 的 review_routing 分流;读取 references/workflow-map.yaml、references/artifact-detection.md 和共享 review-boundaries.md。命令名只能使用 workflow-map.yaml 中逐字一致的 canonical command,禁止自造别名。默认跟随用户输入语言,显式指定时以用户指定为准;模板或子任务继续传递同一 output_language;TRACEABILITY-METADATA 字段名、枚举值、ID、comment markers 保持英文。

适用场景:项目状态诊断、文档链路断点定位、下一步 skill 选择、候选实现是否进入源码评审、是否展示 Prototype 或 Testany 自动化分支、Guardrails 触发判断等。若用户要求长期维护任务与进度,可路由到 /delivery-secretary。

限制:所有“已完成”“已批准”“下一步建议”必须基于仓库证据,缺证时只能标注 low confidence;元数据优先于文件名,冲突时以元数据与审查证据为准;reviewer 先于下游 writer;最多给 3 个下一步;不得把任意 HEAD 当作 Candidate;Code Review 通过仅表示源码 Candidate 准出,不代表 CI、merge、deployment 或 release 批准。收费、价格、具体平台与安装命令暂未提供。