ruby-refactor-best-practices
社区维护的 Ruby 重构最佳实践技能,包含 8 大类共 45 条按影响优先级排列的规则,用于指导自动化重构与代码生成,适用于重构、审查或重组 Ruby 代码以改进设计的场景。
找到适合任务的 Agent Skill,阅读介绍并复制安装命令。
更新于 11-19 00:15
41,836 个结果
社区维护的 Ruby 重构最佳实践技能,包含 8 大类共 45 条按影响优先级排列的规则,用于指导自动化重构与代码生成,适用于重构、审查或重组 Ruby 代码以改进设计的场景。
针对 Rust clap 命令行参数解析的实践指南技能,包含 42 条规则、8 个类别并按影响优先级排序,用于设计、审查或重构 Rust CLI 应用,覆盖类型驱动设计、derive API、参数配置、校验解析、子命令架构、帮助文档、错误处理与测试模式。
面向 Codex-RS Rust 代码库的 40 条最佳实践指南,分 8 类,每条含正误示例,覆盖错误处理、类型设计、模块组织、Serde 协议、异步并发、配置系统、TUI 约定与构建 CI。
一份面向 Rust 的惯用写法规则集,覆盖所有权与借用、错误传播、类型安全、集合与迭代器、异步模式、API 设计、序列化与性能,共 41 条规则,每条含正误示例与影响等级。
dev-cmake 是一个面向 CMake 与 Make 构建文件编写、重构、审查和调试的技能,宣称以资深首席工程师的视角产出简洁、有明确理由的构建脚本。其内容包括现代 CMake 的核心哲学(以 target 与属性为中心、显式声明 PRIVATE/PUBLIC/INTERFACE、最小暴露面)、项目结构示例、target 定义模式、依赖处理(find_package、FetchContent)、生成器表达式,以及 Makefile 的结构约定、模式规则、自动变量与整洁写法。同时列出应避免的反模式(如 include_directories、link_directories、file(GLOB) 等)和收尾质量检查清单,并提供 CMake 模式、Make 模式与反模式三份参考文件。适合需要创建、重构、评审或排查 CMakeLists.txt 与 Makefile 的开发者使用。
Angry User Simulator 是一个面向 QA 自动化工程师的 Playwright 测试技能,用于模拟激进、急躁、不可预测的用户行为,如快速连点、随机导航、表单滥用、标签页刷屏和异常交互序列,以发现结构化测试难以暴露的隐藏缺陷。
介绍测试驱动开发(TDD)方法的技能,核心是红-绿-重构循环:先写失败的测试,再写最小实现使其通过,最后重构,并给出 JavaScript/TypeScript、Python、Java 的多语言示例。
SSD Git Commit 是一套提交信息与版本发布规范,要求使用 Conventional Commits 标准编写 commit message、以 Semantic Versioning 管理版本,并配合 release-it 自动化发布。适用于编写 commit message、确定版本号、使用 release-it 或讨论 commit 类型/scope/破坏性变更时。
一个面向代理的完整开发工作流技能,在任意 Git 仓库中强制执行可重复、高质量的编码流程,覆盖仓库卫生、依赖与安全检查、提交前验证、密钥检测、提交推送与 PR 生成,每个阶段可暂停并请求用户输入。
一种多智能体调试与评审协议:通过并行独立诊断、共识综合、对抗式审查和加固修复,产出经得起独立分析与对抗质疑的修复方案。适用于多层缺陷、框架疑难和高风险部署。
这是一个用于审查 FastMCP 代码变更的技能,面向自审或审阅拉取请求(PR)。它要求先阅读 AGENTS.md、CONTRIBUTING.md、相对合并基点的完整 diff,以及此前的审查线程与回复,并在上下文中追踪被改代码(含调用方与共享抽象),一次性收集独立的、有实质影响的发现。它强调从已发布文档、测试、历史和维护者决定中确定预期契约,区分可复现行为与 bug,判断改动是修复根因还是在别处补偿。在兼容性方面,它要求评估行为变更(包括 bug 修复)、比较省略默认值、显式覆盖、错误、序列化与受支持配置,追踪共享分支到相邻行为及所有受影响的 MCP 组件类型,并明确说明什么既有输入会改变行为、是否必要、以及保留旧行为的迁移方式;对依赖变更需验证声明的最低版本是否支持所用全部 API。发现报告要求给出可触发的缺陷、具体触发条件与后果,不重复已解决或无新证据反驳的机器人意见,避免猜测性问题和装饰性阻塞项。审查回归测试时关注真实失败与相邻契约,记录运行了哪些检查及在哪个修订版本。发布后用 review-pr 跟踪 CI 与自动反馈;合并仍需用户授权和仓库当前合并门禁。
audit-legacy-controller 是一个只读的代码审计技能,用于分析 PrestaShop 中遗留的 Admin{Domain}sController.php 控制器文件,而不对其进行任何修改。该技能会通读整个控制器文件,提取其中渲染的每一个字段、每一个 action 方法以及每一次 Hook::exec() 调用,并输出结构化字段映射,帮助开发者了解旧控制器的实现细节。
用于为 PrestaShop 共享组件生成精简的 CONTEXT.md 文件。该技能通过实际探查代码库,为位于 src/Core/{Name}/ 与 src/Adapter/{Name}/ 下的共享组件生成上下文文档,最终写入 `.ai/Component/{Name}/CONTEXT.md`(若目录不存在会先创建,完成后向用户确认文件路径)。生成内容以“路径而非清单”为原则,包含层表、非显而易见的模式、典型示例等,目标篇幅约 30 至 50 行,超过约 80 至 100 行则建议拆分为子上下文。组件与业务域不同:组件不包含 CQRS 结构,是为多个域提供共享基础设施。当用户要求“generate a context…”时触发该技能。
该技能属于 PrestaShop 项目中的开发辅助技能,用于按照 CQRS 模式创建批量操作命令(Bulk Command)及其处理器(Handler)。主要涵盖两类批量操作:批量删除与批量切换状态。技能要求所有批量处理器继承 AbstractBulkCommandHandler,逐项捕获错误并在失败时继续处理剩余项,最终通过 BulkCommandExceptionInterface 报告失败。批量删除命令类构造函数接收 int[] 类型的 $ids 并提供 getIds(): array 方法;批量状态命令类构造函数额外接收 bool $expectedStatus(true 表示启用,false 表示禁用),提供 getIds(): array 与 getExpectedStatus(): bool。处理器放置在 src/Adapter/{Domain}/CommandHandler/,删除处理器逐个调用仓储删除方法,状态处理器逐个加载实体并按命令传入的目标状态设置 active 后更新(注意是使用命令中的目标状态而非翻转当前值)。接口放置在 src/Core/Domain/{Domain}/CommandHandler/,均返回 void,异常通过抛出而非返回方式传播。若实体没有批量网格操作,应跳过该技能。
PrestaShop 中用于创建 CRUD(可识别对象)表单数据流层的技能:包含 DataProvider、DataHandler、错误处理与服务注册,基于 CQRS 命令模式,适用于实体新增/编辑页面。
该技能用于在 PrestaShop 的 Adapter 层创建 Doctrine 仓储(Repository)类。它是唯一接触数据库的类,所有 handler 都委托给它。技能覆盖多店铺(multistore)模式,涉及 ShopConstraint、AbstractMultiShopObjectModelRepository 等约定。适用于按照 CQRS 约定新增领域仓储,包含基类选择、核心方法(get/create/update/delete)、多店铺写入模式、子资源替换与增量更新策略,以及不得使用 Db::getInstance()、不得硬编码 Context 等规则。
PrestaShop 技能:使用 NavigationTabType 创建多标签页表单布局,适用于字段繁多、需按标签分组的复杂实体表单,而非默认的单页表单模式。
PrestaShop 技能:为实体列表创建网格定义(Grid Definition),包含列、行操作、批量操作、过滤器与搜索条件 Filters 类及服务注册,覆盖 GridDefinitionFactory、GridDataFactory、GridFactory 三件套用法。
PrestaShop 技能:创建 Doctrine DBAL QueryBuilder 以获取网格行数据,并可选创建 GridDataFactory 装饰器做后处理。列别名须与网格定义严格匹配。
该技能说明如何为 PrestaShop 后台网格添加拖拽排序功能,需在网格定义中加入 PositionColumn、配置位置更新路由,并在控制器与仓储层处理位置更新。
用于为 PrestaShop 仓库创建符合贡献规范的 PR,自动读取 PR 模板并填写必需的元数据表格。当用户要求创建、提交或推送 PR,或提到 "pull request" 时触发。
用于在 PrestaShop 仓库中创建 GitHub issue,跟踪在下一个大版本中实际移除旧版 Admin{Domain}sController 的工作,包含前置条件、待删文件、待更新文件、里程碑与标签等约定。
在 PrestaShop 中建立保存配置的设置表单,说明配置读写、数据提供器、表单类型和四项服务定义之间的职责。
generate-migration-manifest 是 PrestaShop 官方仓库中的一个技能(skill),用于将 `audit-legacy-controller` 与 `audit-object-model` 两个审计步骤的输出综合为一份 `migration-manifest.md`,作为迁移规范。该技能要求创建一个迁移清单文档(通常位于约定位置如 docs/migration/{domain}-manifest.md 或项目根目录),并按八个部分组织内容:命令、查询、表单字段、网格列、网格过滤器、子资源、钩子和里程碑决策。文档需涵盖 Add、Edit、Delete、BulkDelete、BulkToggleStatus、ToggleStatus 等命令及其必需/条件标记;列出 GetForEditing、GetList 等查询;逐个字段记录类型、可翻译、必填和验证规则;列出网格列与过滤器类型;显式标记需要独立命令与仓库的子资源;列出旧钩子及 Symfony 等价物;并根据复杂度给出迁移拆分建议。规则强调该文档是唯一事实来源,后续迁移步骤必须引用它而非旧文件,且 ObjectModel 审计中发现的每个字段都必须在清单中体现为表单字段或网格列,遗漏子资源会导致处理器中静默数据丢失。