SuperAPI AI 工具集

portal

通用与其它

查看项目

更新于 10-15 21:46

技能介绍

用途:Portal 用于在问题跟踪器和当前分支上选择一个推荐动作。它既可读取整个看板进行路由,也可针对指定 issue(id 或 URL)单独路由,还支持 run 参数对命名范围做串行延续。路由发现阶段为只读,不会认领工单。

主要能力:读取 tracker(默认 GitHub,可通过 docs/agents/issue-tracker.md 配置 Tracker 行与 Adapter 标志),区分 ready-for-agent、needs-triage、needs-info、ready-for-human 等标签,识别 map(scry:map、scry:<type>,旧称 wayfinder)。支持模板:无参数时解析整块看板并按优先级检查候选;给定 id 时只检查该目标及其必要关联;run <map-or-build-effort> 进入 Stage Run 串行执行;go 表示跳过 Stage 5 提问直接执行。

使用方式:按参数决定流程,先解析 tracker 与标签字符串(Stage 1),再根据空参数、id 或显式命名延续进入对应阶段。报告以 markdown 表格输出,包含 Branch、Maps、Build effort、Roadmap、Ready、Inbox、Next step、Prompt 等行;授权交接时读取同级技能目录下的 SKILL.md 并从头遵循。命令脚本位于 scripts/tickets.sh 与 scripts/map.sh,参数中不做变量赋值,GitHub Enterprise 需内联传入 GH_HOST。

适用场景:适用于需要从看板或指定 issue 决定下一步动作、路由工单、延续命名构建或规划努力的开发协作流程。

限制:发现阶段只读,不认领、不写入、不发布;无可行路线时不提问直接报告并停止;run 模式不认领全局队列、不在 map 目的地后开始实现、不合并 PR;已保存状态不授予权限。缺失或不可访问的项目按普通行为处理。具体标签配置、跟踪器适配等细节需参阅对应文档,资料未提供更完整说明的内容暂未提供。