SuperAPI AI 工具集

repo-skillopt

通用与其它

查看项目

更新于 10-16 02:35

技能介绍

用途:帮助编程智能体理解、梳理、记录、接手、重构、修改或评估遗留代码库。当用户提出“解释这个代码库”“总结架构”“如果改动会怎样”“是否安全”等同类请求时激活;通用闲聊、无关写作、无需仓库级理解的单文件编辑不激活。

主要能力:产出一份包含 19 个固定章节的 Repository Specification(仓库概览、技术栈、构建与运行命令、主要入口点、架构分层、核心模块、领域模型、数据模型、外部集成、控制流追踪、数据流追踪、依赖图、配置图、测试策略、部署假设、变更影响图、已知风险、未知与未决问题、证据索引)。每条重要主张必须标注 [fact]、[inference]、[unknown] 或 [human] 之一,并引用具体文件与符号;README 仅作证据之一,需与代码、配置、测试、命令输出相互印证。

工作流:依次执行仓库结构分诊、识别语言/框架/包管理器/运行时、检查清单与配置与测试与部署与入口、映射模块与依赖与领域概念、从入口追踪具体行为、增量落盘写出规范、梳理风险与未知项、最后确定性地补全符号清点,避免遗漏函数与类。符号需按文件登记计数(定义数、已分析数、未分析数),排除生成或第三方目录。

人工反馈闭环:反馈先记录为 Feedback Item 再应用,共 11 种类型(correction、confirmation、missing-context、terminology、quality-rating、avoid-path、deeper-analysis、criticism-of-claim、format、detail-level、cross-agent-difference),scope 分为 repository-scoped 与 candidate-for-generic。反馈既即时修订当前规范(保留历史、标注 superseded、递增修订号),也作为技能收敛的长期输入。

技能收敛:当出现重复模式(通常三个以上相关反馈项)时可提出有界的 Skill Edit Proposal,编辑类型有 ADD、REPLACE、DELETE、REORDER、SPECIALIZE、GENERALIZE,须为单一接受/拒绝单元且评审时间不超过 5 分钟;只有 scope: generic 可进入候选,且须通过验证门(在留出参考集上重跑规范、各维度评分不退化、确定性检查通过)。被拒提案保留以备审计。

产物位置:分析对象仓库根目录下 .reposkillopt/,含 specs/、feedback/、rollouts/、proposals/ 子目录。规范中还要求数据模型含真实表结构的 mermaid erDiagram、业务流程逐入口枚举与流程图,图表本身不带引用,每个步骤仍须有带引用标注的对应行。

限制:资料未提供具体安装命令、价格、收费模式与支持的运行时适配器细节,这些暂未提供;技能本身强调不得凭浅层检查夸大架构,无法静态解析的跳转应标为 [unknown] 而非省略。