SuperAPI AI 工具集

Skill 广场

找到适合任务的 Agent Skill,阅读介绍并复制安装命令。

更新于 11-17 00:07

全部 Skills

254,818 个结果

benchmark-checklist

benchmark-checklist 是一份用于核查性能测量结果的检查清单技能,来源为 mariusflorescu/pstack-t3。它的核心用途是在向他人报告性能数据或据此采取行动之前,先对测量过程与结论进行审查,覆盖限流因素、参数调优、物理极限、错误计数、可重复性、实际相关性和“工作是否真正发生”等方面。该技能适用于产出性能数字的场景,例如 PR 修改前后的对比、性能回归声明、爬山法(hillclimb)测试脚手架,或库与配置选型。它要求每个问题都用运行证据回答,而不是对代码的猜测。对于用户只是想要粗略量级的场景,允许只跑一次,但仍需检查错误与工作发生两项,并说明这是单次运行;且选项之间的取舍不能只看量级。运行前需要先用将要发布的口径写下预期结论,阅读测量脚本了解它计时、计数和忽略的内容,并用 uptime 与 nproc 检查负载与核数。其余详细问题、报告格式与相关性能材料说明均见正文。

测试与质量134 次安装

principle-attack-the-premise

「攻击前提」(Attack the Premise)是一条调试与问题排查原则:当两个或更多共享同一前提的修复方案在同一个关卡上失败时,应当怀疑前提本身,而不是继续修补方案。做法是先写下那个被所有失败方案共同默认的前提,然后在实施下一次修复前先做一次「普查」(census),统计每个参与者(actor)在失衡中的分布,判断失衡集中在谁身上;若每次运行都由相同的少数参与者承担大部分失衡,就说明存在某种机制在分配该角色,需要找出这个分配机制,并将其作为下一个「为什么」去追根因。最终目标是消除这种不对称,而不是补偿它,可通过轮换角色、随机化分配或移动角色来实现,使没有任何参与者在每次运行中都持有该角色。该原则与「从第一性原理重新设计」不同,后者是围绕新需求重建设计,而此原则是质疑当前设计所假设的某个事实。资料未提供该技能的安装命令、价格、平台支持等具体信息。

编程与开发134 次安装

principle-guard-the-context-window

该技能用于在上下文窗口逐渐被占满的情况下保护主线程的推理质量。当出现大体量输出、超长文件、重复读取以及扇出式规划等场景时,可应用此原则:把批量处理路由到子代理执行,主线程只保留摘要信息而非全部原始内容。其核心理由是上下文溢出会降低推理质量、产生压缩失真并中断进度。做法上强调按阶段控制规模与范围:限制每个阶段处理的文件数量、设置轮次预算,并计入机制本身的成本。

智能体与模型134 次安装

principle-make-operations-idempotent

该技能围绕“让操作具备幂等性”这一设计原则,适用于设计命令、生命周期步骤或处理循环的场景。它强调:无论操作运行多少次、从何处开始,都应收敛到相同的正确终态。核心内容包括:启动时扫描已有状态、清理陈旧产物、接管存活会话;基于内容等价性而非创建顺序进行清理;使用基于 PID 的陈旧锁检测实现自愈锁;以及幂等调度,使失败任务能干净地重新生成、每轮循环后重新生成新输入。技能还提供自检问题:连续运行两次会怎样、上一次在任意点崩溃会怎样、重新执行是否收敛到同一终态;若答案取决于遗留状态,则需增加对账步骤。

编程与开发134 次安装

principle-migrate-callers-then-delete-legacy-apis

该技能定义了一条内部 API 重构原则:当决定采用新的 API 设计后,应在同一波重构中迁移所有调用方并删除旧 API,而不是保留兼容层。适用于没有外部用户依赖向后兼容、项目能够承受协调式破坏性变更、且该新 API 属于简化或重构计划一部分的场景。规则要求:不要仅因为内部调用方仍存在就保留旧 API 路径;盘点调用方、迁移并立即删除旧 API;将临时适配器视为例外并设定时间限制,而非默认架构;更新测试以断言新契约,删除仅保护重构前实现细节的测试。资料同时指出,同时保留新旧 API 会造成双路径复杂性、拖慢清理,使代码库呈现只增不减的状态。

编程与开发134 次安装

principle-model-the-domain

「模型化领域」(Model the Domain)是一个面向编写有状态逻辑的编码原则技能,属于 pstack-t3 技能集。其核心主张是:把真实的领域逻辑编码进一个数据结构,而不是把它散落在各个条件分支里。一个与领域相匹配的结构可以让非法状态无法被表示,并删除分支。该技能建议在以下情形使用:编写有状态逻辑、代码分支过多,或在多个文件中重复同一种形状假设。它给出的做法包括:用状态机替代散落的布尔值、阶段或生命周期检查;用类型化模型替代松散参数或重复的形状假设;用映射、注册表、查找表或判别联合替代跨文件分发的分支;用 reducer 或命令/事件模型替代临时性的状态变更;以一块领域知识为中心组织模块,而不是按 load、validate、transform、save 之类的执行顺序组织;用小的模块边界收拢重复行为、归属关系或不变式;在访问模式需要时使用队列、缓存、索引、图、树或规范化集合。它同时强调不要强行抽象:如果现有形状已经清晰、局部且不太可能增长,宁愿写普通代码;对只增加间接层却不消除分支、重复规则、非法状态或生命周期风险的抽象应保持怀疑。遗漏本原则的信号是:新功能只是在现有 if/else 链上再加一个分支,或出现必须与前一个布尔值保持同步的第二个布尔值;按阶段命名的时间性分解也是信号,因为阶段式模块会在各步骤间重复相同的领域规则。

编程与开发134 次安装

principle-test-behavior-not-implementation

这是一条关于测试编写原则的技能,核心主张是“测试行为,而非实现”。它要求测试像真实用户那样调用代码,并断言用户实际看到的确切结果。凡是即使所有被导入函数都返回 undefined 或错误值仍能通过的测试,都应重写或删除。资料列出了若干不合格的测试形态:断言过于宽松或没有断言(如 toBeDefined、toBeTruthy、not.toThrow、toBeGreaterThan(0));只检查是否被调用或不存在(如 toHaveBeenCalled、not.toHaveBeenCalled、toBeUndefined、toEqual([]));期望值由被测代码自身计算得出(如 expect(f(a)).toBe(f(a)));只是复述常量、配置默认值、表格行或提示词字符串;以及断言测试自己构造的数据而没有调用被测对象。修复方式是:在测试体内用具体输入调用被测对象,并断言字面输出或效果;对 mock 断言其收到的载荷;对“不存在”的断言,还要在另一个输入上断言其存在;对常量,改为用某个输入测试读取该常量的机制,而不是复述该值。同时应保留跨表格行的关系检查(如某个键出现在两张表中、父项存在)以及 *.test-d.ts 类型检查。

测试与质量134 次安装