SuperAPI AI 工具集

prepare-feedback-proposals

编程与开发

查看项目

更新于 11-11 05:59

技能介绍

用途

该技能用于在完成一次审查后,根据用户选定的 Hub 反馈发现,准备可复用的仓库指导改进提案。只有在用户明确请求提案或解决方案后才会运行。调查阶段为只读;同意调查、认同某个发现或请求解决方案,都不构成编辑授权。

主要能力

  1. 解析审查与选择:读取私有交接约定并校验所提供工件;若缺少必需的已安装引用,报告其确切路径并停止。确认仓库身份与当前消费方已验证的 origin 一致。要求完整有效的审查结果和明确选定的发现 ID;格式错误的判断、缺失的已保存来源记录或不完整覆盖会阻断整个交接。

  2. 调查指导规则:读取当前消费方说明与上下文解析规则,遵守已保存的来源跳过与主题限制。根据发现类型选择对应权威文档(产品发现用 PRODUCT-DESIGN.md,设计系统发现用 DESIGN-SYSTEM.md,其他使用声明的所有者),必要时查看 REPOSITORY.md。将选定证据与现有指导的适用性、例外和权威性进行比对。

  3. 给出结论:每个选定发现必须被赋予以下一种结果并附解释:提议指导变更(说明缺口或矛盾、措辞帮助、适用性与例外、现有权威所有者)、已被覆盖(匹配的指导及加载证据,不重复规则)、需要澄清(缺失证据、未解决的权威或用户决策)、建议环境调查(疑似关联、有限观察及未验证部分)。环境转介是结果而非审计或修复许可。

  4. 展示方案并等待:为每个拟议变更展示稳定的提案 ID 及发现 ID、理由、不含原始私密评论文本的证据链接、确切目标路径,以及展示所有预期编辑的前后对比或差异。提案保留在聊天或私有会话工件中,不写入仓库草稿。合并兼容的重叠编辑,矛盾提案需用户明确决策。展示所有结果后,询问用户批准、修改或拒绝哪些提案 ID。

  5. 应用:仅在用户明确批准所展示的变更后,才读取“应用已批准指导”流程;在此之前停在待审查提案阶段。

适用场景

适用于代码审查或反馈流程结束后的后续环节:用户要求将审查发现转化为仓库指导改进方案时。不适用于审计或修复环境组件、默认值、模板、已安装技能流程、依赖与配置,也不处理个别原型修复、上游贡献或 Hub 学习决策。

限制

调查范围限于选定发现和消费方拥有的可复用指导;保留有意的定制,区分提供方事实、团队决策与拟议默认值。历史证据不能证明当前行为;用户对来源有争议或报告证据变化时,应暂停该发现等待重新审查。缺失上下文、未解决策略冲突或不可用证据只阻断受影响发现。相关性置信度不能替代变更合理性的证据。