Agent Skills
› ciembor/agent-rules-books
ciembor/agent-rules-books
GitHub基于John Ousterhout软件设计哲学,用于降低复杂度、设计模块边界、审查API与抽象。在涉及模块/API设计、信息隐藏或重构浅层接口时触发,旨在优化认知负载与设计权衡。
Install All Skills
npx skills add ciembor/agent-rules-books --all -g -y
Skills in Collection (14)
基于John Ousterhout软件设计哲学,用于降低复杂度、设计模块边界、审查API与抽象。在涉及模块/API设计、信息隐藏或重构浅层接口时触发,旨在优化认知负载与设计权衡。
模块设计决策
API设计与审查
重构浅层接口
评估抽象深度与信息隐藏
npx skills add ciembor/agent-rules-books --skill a-philosophy-of-software-design -g -y
应用整洁架构规则,分离业务逻辑与框架、数据库等细节,确保依赖方向正确,适用于涉及架构边界和技术解耦的设计决策。
涉及架构边界划分
需要隔离业务逻辑与基础设施
npx skills add ciembor/agent-rules-books --skill clean-architecture -g -y
应用整洁代码规范,优化日常代码的可读性、命名、函数设计及职责划分,提升代码质量。
重构代码以提升可读性
优化变量或函数命名
拆分过大函数以明确职责
改进控制流逻辑
增强代码可测试性
npx skills add ciembor/agent-rules-books --skill clean-code -g -y
提供遵循Steve McConnell风格的代码构建规范,指导例程、变量、类及控制流等实现细节,强调防御性编程与编码标准。
需要遵循严格编码规范的代码实现
涉及类设计或控制流的开发任务
编写防御性代码或单元测试
npx skills add ciembor/agent-rules-books --skill code-complete -g -y
用于指导高数据密集型系统的设计,涵盖可靠性、扩展性、一致性、复制、事务、流处理及模式演进等核心原则,辅助进行技术权衡与决策。
设计数据系统架构
评估数据一致性或扩展性方案
处理分布式事务或流处理逻辑
规划数据迁移或模式演进
npx skills add ciembor/agent-rules-books --skill designing-data-intensive-applications -g -y
提供轻量级领域驱动设计(DDD)指导,涵盖限界上下文、子域、聚合及战术建模,强调在保持实用性的同时减少过度仪式化。
需要应用 DDD 原则进行架构设计
处理限界上下文或子域划分问题
进行战术建模如聚合根和领域事件设计
npx skills add ciembor/agent-rules-books --skill domain-driven-design-distilled -g -y
应用DDD规则进行复杂领域建模,定义限界上下文、保护通用语言及设计聚合根。涉及战略模式与战术设计决策。
需要进行领域建模
定义限界上下文
设计聚合根
npx skills add ciembor/agent-rules-books --skill domain-driven-design -g -y
指导在代码中实施领域驱动设计(DDD),涵盖聚合、事件、仓储等核心概念的实现规范。
实现 DDD 聚合边界
定义领域事件或仓储
npx skills add ciembor/agent-rules-books --skill implementing-domain-driven-design -g -y
指导在构建企业级应用时,依据Martin Fowler的架构模式选择分层、服务层、领域模型、仓储等结构。用于规范代码设计与架构决策,确保遵循最佳实践。
设计企业应用架构
选择数据访问模式如Repository或DTO
决定使用事务脚本还是领域模型
npx skills add ciembor/agent-rules-books --skill patterns-of-enterprise-application-architecture -g -y
用于诊断代码异味、选择重构技术并控制重构范围,避免无节制的设计变更。
诊断代码异味
选择重构策略
执行代码重构
npx skills add ciembor/agent-rules-books --skill refactoring-guru -g -y
遵循 Martin Fowler 原则,在保持行为不变的前提下优化代码结构。处理代码异味、小步重构及测试驱动清理,分离重构与功能变更。
存在代码异味需优化
需要在不改变行为的情况下改进代码结构
执行小步重构或测试驱动清理
npx skills add ciembor/agent-rules-books --skill refactoring -g -y
应用生产可靠性规则,指导故障处理、超时重试、熔断器、可观测性及部署行为的设计与决策,提升系统稳定性。
设计容错机制
配置超时与重试策略
实现熔断器模式
优化部署与运维就绪性
npx skills add ciembor/agent-rules-books --skill release-it -g -y
应用《程序员修炼之道》中的实用编程原则,在工程判断、反馈循环、知识复用、自动化及适应性设计等方面提供决策指导。
进行代码重构或架构设计时寻求最佳实践
需要平衡技术债务与快速交付的权衡决策
优化开发流程以提高反馈速度和自动化水平
npx skills add ciembor/agent-rules-books --skill the-pragmatic-programmer -g -y
用于安全修改难以测试的遗留代码,通过特征测试、隔离点、Sprout或Wrap方法降低风险。
修改高风险遗留代码
缺乏测试覆盖的代码变更
需要引入隔离点或增量风险控制
npx skills add ciembor/agent-rules-books --skill working-effectively-with-legacy-code -g -y


