SuperAPI AI 工具集

platform-request

智能体与模型

查看项目

更新于 10-15 22:11

技能介绍

用途:当用户(领域专家而非开发者)提出的需求不属于本应用可构建范围,而需要平台先变更时,本技能负责产出一份完整的 GitHub issue,标签为 kind:platform,使用仓库中的 .github/ISSUE_TEMPLATE/platform.yml 表单,供平台维护者及其编码智能体直接据以开发,无需再次询问用户。

触发时机:docs/CAPABILITIES.md 将需求列为“Not possible today”;改动涉及 vendor/、deploy/、.github/、server/src/auth.ts、新模型提供方、外部系统连接器、调度器或邮件;两次诚实尝试(每次均验证假设)后仍无法定位故障,或平台行为与文档不符;改动预计超过一天,或涉及安全与个人数据。若属于本应用可完成的产品改动,则应直接构建(new-agent、verify-app 技能)。不确定时查 docs/CAPABILITIES.md 与 gh issue list --label kind:platform --state all。

主要步骤:一、访谈用户,用其语言逐条提问,收集需求原话与原因、三个真实场景(去除可识别个人信息)、当前做法与代价、决定性时刻、验收标准(“The app shall …”)以及限制与紧急程度。二、收集证据:尝试过的命令、错误文本、验证证据(network-summary --since-mark、console --errors、截图)与运行记录(verify api /api/runs),仅用虚构数据;版本信息 git rev-parse --short HEAD、vendor/boring/SOURCE.json 中的库提交、已部署版本;指出被阻塞的 CAPABILITIES.md 行或与文档矛盾之处,以及当前最接近的可行方案。三、需要可视化时制作原型:issue 内文字线框图;HTML 原型加截图 node scripts/mock-shot.mjs docs/requests/<slug>/mock.html docs/requests/<slug>/mock.png,提交到 request/<slug> 分支(绝不提交 main)并推送、链接文件;若改动现有页面,附今日页面截图对比。四、按 issue-template.md 起草到 .verify/request-<slug>.md,逐节填写,缺失写 unknown;向用户展示标题、摘要与验收条目并确认后再提交:gh issue create --label kind:platform --title "<the need, in a few words>" --body-file .verify/request-<slug>.md,随后告知链接、后续流程与临时替代方案。

限制:issue、原型与证据中不得出现真实个人数据;不得为“解封”而改动 vendor/、deploy/、.github/ 或 auth;不得跳过访谈直接提交。未完成的工作要么回退,要么完成并在 issue 中说明。