principle-minimize-reader-load
一条软件设计原则:以“读者理解代码所需付出的负担”为衡量标准,追踪问题到答案之间的层层间接,以及读者必须记住的隐藏或可变状态,主张内联只有单一调用者的包装层、合并重复的透传层、压缩接口、缩小状态作用域并派生而非同步。
找到适合任务的 Agent Skill,阅读介绍并复制安装命令。
更新于 11-07 00:13
40,073 个结果
一条软件设计原则:以“读者理解代码所需付出的负担”为衡量标准,追踪问题到答案之间的层层间接,以及读者必须记住的隐藏或可变状态,主张内联只有单一调用者的包装层、合并重复的透传层、压缩接口、缩小状态作用域并派生而非同步。
该技能是一条工程实践原则:把多步骤工作(批量清扫、迁移、相似改动的连续执行)拆成可验证的小单元,每个单元以可检查的状态结束,当前单元未通过检查前不推进。它同时规定了提交与 PR 的堆叠方式,让审查者可以复现整个过程。
该技能强调在系统演进中「先做减法,再做加法」。当准备新增功能、重构或重写代码时,应先删除死代码、冗余校验器和占位引用,再在更简单的基础上构建。它主张把简化当作持续投入,让设计在相同或更小的表面积下变得略微更简单且更有能力;先削减再打磨,以最小可行形态为起点;只针对已观察到的真实用途设计,不添加规格之外的猜测性校验器、解析器或守卫;精简提示词,去除冗余指令和过度模板;当某个引用没有新内容时直接删除,而不是留下占位符。
一套关于静态类型语言类型系统纪律的原则技能,主张把类型检查器当作证明助手,用不可表示非法状态、语义品牌、边界解析、穷尽匹配等模式在编译期消除不可能状态与未处理分支,适用于设计类型、审查函数签名或编写代码时。
TypeScript 最佳实践是一份针对 .ts 与 .tsx 文件的编码规范技能,用于在阅读或编辑 TypeScript 代码时应用类型系统纪律。它主张用判别联合建模互斥变体、用品牌类型区分同源原始类型、用构造式建模让非法值无法被构造,从而在编译期而非运行时排除错误状态。同时强调对外部数据使用 unknown 而非 any、优先使用运行时 schema 库并从中推断类型、避免 as 断言、按判别 switch 到类型守卫的层级收窄类型、用 never 检查穷尽性、用 satisfies 替代 as、在边界处解析并信任内部类型,以及通过对象参数、真实测试与结构化日志提升可维护性。该技能要求先应用 type-system-discipline 原则技能,具体示例见 references/patterns.md。
why 是 p3-stack 中用于追溯代码设计动机与意图的技能,回答"为什么这样做"类问题,适合设计决策、回归、复盘与数据依据阈值等场景。它与 how 技能互补。
用于编写 Git 提交信息的技能,在用户要求撰写或起草 commit message 时激活,按项目提交风格规范生成格式化提交信息。
用于接收 BaseLinker(Base.com)回调的技能:其传输方式为 HTTP HEAD、无请求体、参数在查询串中,且平台不提供任何签名校验,需自行处理并用 API 补全订单详情。
woostack-change 是一个用于实施小型、有边界、非缺陷类增强或重构的工作流命令,依据用户目标或指定的 GitHub issue,在一个隔离 worktree 与任务分支中完成,最终产出至多一个可评审的 PR。
查询 HTX USDT-M 永续合约的强制平仓订单,用于监测多空挤压与爆仓聚集区。公开数据,无需 API 密钥,通过 htx-cli 调用。
面向 Rust 的分布式系统技能,覆盖 Raft 共识、2PC 分布式事务、一致性模型、Snowflake 分布式 ID、基于 etcd 的分布式锁与事件溯源等内容,并罗列脑裂、活锁等常见问题及思路。
Rust 错误处理进阶技能,讲解 Result、Option、panic 的选用,thiserror 与 anyhow 的适用场景,错误上下文与错误链,以及常见反模式与最佳实践。
Rust Pin 与自引用类型专家技能,覆盖 Pin、Unpin、Future、async 状态机、pinning 投影与内存稳定性保证,帮助判断何时需要 Pin、选择堆或栈固定策略并规避常见陷阱。
面向 Rust 的智能指针与资源管理技能,提供 Box、Rc、Arc、Weak、RefCell、Cell、内部可变性、RAII 与 Drop 的选择决策与常见错误处理建议。
面向全栈功能开发的编码技能,强调先探测项目技术栈再写代码,遵循“先能用、再正确、后快速”的原则,覆盖 TypeScript、Python、Go、Ruby、Java、Rust 等多种语言。
Phoenix 文件上传技能,用于实现上传与文件服务功能前调用。覆盖手动上传、上传配置、静态路径设置与常见陷阱,强调服务端校验、错误展示、安全文件名生成与改动后重启服务器。
refactor-code 是面向 Elixir 项目(igmarin/elixir-phoenix-skills 技能集)的重构技能,用于在“不改变既有行为”的前提下调整代码结构。其核心原则是用小步、可回滚的改动替代大规模重写,并把设计改进与行为变更严格分离。技能要求:先写表征测试(characterization tests)并在当前未重构的代码上运行通过,之后才能改动任何生产文件;每一步只处理一个边界,绝不一次抽取两个抽象;重构过程中保持公共接口稳定,如需兼容垫片(adapter/facade/wrapper)须记录其移除条件;每步后运行 mix test,失败则停止、回滚并排查,最后运行完整测试套件。技能给出常见重构手法的前后对比示例:抽取私有函数以降低 ABC 复杂度、用 with 展平嵌套 case、把长管道拆成命名函数、抽取 Phoenix 内部 context 边界。它还强调不得借 context 抽取掩盖新增或改变的 I/O(网络、文件系统、外部服务、遥测),须在文档中记录 I/O 面并证明副作用面未变;测试输出只能标注为 Observed output,禁止伪造或以预期输出替代。该技能与 code-review、code-quality、testing-essentials、apply-phoenix-liveview-conventions 等技能配合使用。
一个用于将 Next.js 项目升级到最新版本的技能,依据官方迁移指南与 codemod 自动处理破坏性变更,并更新依赖与类型后验证构建。
一套面向 React 的组件组合模式指南,用于解决布尔属性泛滥、组件库复用与灵活组件 API 设计问题,涵盖组件架构、状态管理、实现模式与 React 19 API 四类规则。
一套面向 LinkedIn、Meta 与 Google Ads 新用户的交互式上手流程,引导在 Claude Code(本地终端或桌面端 Local 模式)中逐步完成各广告平台 API 凭证配置、生成 .env 文件并测试连接,随后即可用自然语言管理广告账户。
Opentrons Protocol API v2 技能,用于为 OT-2 与 Flex 液体处理机器人编写 Python 协议,覆盖移液、梯度稀释、PCR、板复制及温控、磁力、加热振荡、热循环模块控制,并支持本地模拟。
用于在开发、预发布和生产环境中配置 Clay 集成的多环境方案,通过独立表格、独立 webhook URL 和环境感知代码实现隔离。适合需要按环境区分 Clay 表、管理凭据与限额的团队。
connection-pooling-config 是 API Integration 领域的自动激活技能,用于协助配置连接池相关操作。当请求中提及 connection pooling config,或询问其模式与最佳实践时自动触发,提供分步指导、生成配置与代码并做校验。
用于在项目中实现 Customer.io 核心功能的技能:事务性邮件与推送、API 触发的广播、驱动分群的属性、匿名用户合并以及用户抑制与删除,并强调数据契约、同意合规与可回滚验证。