SuperAPI AI 工具集

vanilla-first

编程与开发

查看项目

更新于 10-16 22:07

技能介绍

Vanilla First 是一个技能(Skill),其核心主张是:在用户提出非平凡的工具或仓库改动请求时,优先寻找能满足用户目标的最小受支持路径,先检查工具已有能力与架构,再考虑自定义代码,同时把使用者自身的操作权限与另一个项目的所有权边界区分开来。

用途

该技能适用于以下情形:一个非平凡的实现或架构提议可能重复某工具已有的能力、跨越所有权边界、依赖特定版本,或者需要引入新的集成。当契合度很明显时,检查应当保持简短;对于在已授权仓库中、有文档记载且可回滚的小修复,可直接完成,无需进行完整的权属审查。

主要流程

第一步是固定所需结果与所有者。需要记录用户需要的行为、重要约束、已知的具体产品/仓库/版本,以及每个受影响边界归谁所有,并把用户问题与提议的实现方案分开。当有助于跟踪非平凡工作时,可使用已有的 issue 或项目记录,而不是为了满足该技能而新建。涉及多个产品、团队或仓库时,所有权映射有用,其字段包括:behavior_or_contract(所需行为)、product_and_repository_owner(各受影响表面的所有者)、maintainer_surface(规范 issue、文档、维护者声明或未知)、state(documented | owner_approved | proposal | investigation | unresolved)。用户自身的操作权限管辖其自有仓库、本地分支和已授权环境中的工作;普通的受支持修复或对自有代码的授权改动,不需要外部维护者预先批准。只有当要修改由另一产品或团队拥有的契约,或声称某项上游贡献已被接受时,维护者的接受才重要。本地分支的决策应与合并许可或将该改动宣传为上游行为的许可分开。

第二步是核查确切受支持的能力。针对相关版本和表面,检查最接近的官方文档,以及在可用时检查源代码、CLI、API 或运行时入口点,找出可满足结果的现有原生工具、工作流、配置、扩展点和服务,并复用相关项目指导而非搜索无关系统。每条重要论断的证据需标记为:Documented(相关版本的官方文档有所描述)、Source-proven(检出的源码包含该路由或行为)、Test-proven(有具名测试或检查器覆盖)、Runtime-proven(实际配置的运行时已证明)、Unknown or unavailable(证据缺失,需说明缺口)。推荐操作路径时,应保留确切版本、命令/API/配置路径、所有者和产物来源;不得把抄来的示例、名称相似的设置、通过的测试或实现猜测当成受支持的契约,也不得仅凭源码检查声称运行时或端到端行为。

第三步是比较最小的自洽路径。可选路径包括:当现有受支持能力满足结果时直接使用;当文档化配置或组合受支持组件足够时使用它们;当存在已证明的缺口时,在受支持的接缝处添加薄适配层;当缺口属于上游且用户希望走该路线时,向上游贡献;当操作者选择独立所有权、需要发布控制,或上游时间无法满足已授权需求时维护分支;只有当证据表明现有架构无法满足要求,或可衡量的未来维护成本证明替换合理时,才替换核心。对于用户自有代码,小幅直接改动可能比新适配层更简单、更易维护。在推荐自定义代码前应说明真实缺口,并比较初始成本之外未来维护、迁移、安全、支持与操作成本;对缺乏证据的估算和市场宣称应加以标注。

第四步是尊重拥有该行为的所有权边界。在已授权所有者边界内、有文档支持的改动可依用户请求推进,日常配置与修复不需要额外审批仪式。当某项重要契约归另一产品/团队所有且其接受状态未决或被明确拒绝时,应暂停实现,在已授权范围内继续有用的调查或本地草稿,并指明所需的确切所有者决策;issue 标签、贡献者协议、本地原型、测试结果或打开的 PR 都不构成接受,除非它覆盖该契约。上游维护者拒绝某设计时,应停止对该设计的重复 rebase、评审、CI 或评分循环,保留有用证据,并找出任何真正独立、受支持且与所有者兼容的路径;拒绝并不决定操作者是否可以实施一个不同的本地分支方案,这仍属操作者决定,有其自身范围与证明。刷新上游贡献前,应确认底层 issue 仍然活跃、当前上游仍缺少该行为、且没有已合并的继任者取代该补丁;仅有打开的 PR 不足以证明工作仍需要。应保留署名,并准确描述已接受、部分接受、已拒绝、已被取代和未决等状态。

第五步是实施并验证已授权的改动。当实现被请求且已获授权时,做出能闭合已证明缺口的最小自洽改动,优先使用受支持的扩展或配置表面;除非结果要求,不要新增服务、依赖、分支、工作流、审批门或迁移。应对改动行为运行聚焦检查,并在任务需要时检查生成的配置、产物或运行时,按实际达到的层级报告证明及仍未验证的部分;仅提供建议的请求以建议和证据收尾,不应悄悄变成实现。

对于非平凡结果,简明的回报宜写明:考虑过的受支持路径及契合或不足的原因;所有者及任何未决的外部契约;所选最小改动及为何保留有用行为;确切的版本/命令/源码证据与验证结果;任何重要的成本、迁移、安全或支持缺口;结果是本地的、仅分支的、提议上游的,还是已被上游接受的。对于结果不言自明的简单任务,可跳过该回报格式。没有相应权限,不得发送、发布、安装或更改共享状态。

适用场景与限制

该技能面向编程助手在工具或仓库改动决策中的行为规范,用于避免重复实现已有能力、越权改动他人契约、无谓新增依赖或服务。其资料未提供收费、价格、平台支持范围或效果数据。