Agent Skills
› ciembor/agent-rules-books
ciembor/agent-rules-books
GitHub基于约翰·奥斯特豪特的软件设计哲学，用于模块与API设计、信息隐藏及抽象深度优化。在降低复杂度、审查接口或重构浅层接口时提供指导原则，帮助减少认知负荷并做出更好的设计权衡。
Install All Skills
npx skills add ciembor/agent-rules-books --all -g -y
Skills in Collection (14)
基于约翰·奥斯特豪特的软件设计哲学，用于模块与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架构设计与编码的任务。
需要实现聚合根或限界上下文
设计领域事件或应用服务
处理复杂业务不变量
npx skills add ciembor/agent-rules-books --skill implementing-domain-driven-design -g -y
指导在构建企业级应用时，依据Martin Fowler的模式选择分层结构、服务层、领域模型、仓储及DTO等架构组件，辅助进行架构设计与代码决策。
涉及企业应用分层结构设计
需要选择领域模型或事务脚本模式
设计数据访问层如Repository或Data Mapper
处理DTO转换或集成模式
npx skills add ciembor/agent-rules-books --skill patterns-of-enterprise-application-architecture -g -y
基于 Refactoring.Guru 原则诊断代码异味、选择重构技术并控制重构范围，防止无序重设计。
诊断代码异味
选择重构方案
避免过度重构
npx skills add ciembor/agent-rules-books --skill refactoring-guru -g -y
指导在保持行为不变前提下优化代码结构，处理代码异味和小步重构，强调测试保障及与功能变更分离。
需要改善现有代码结构但保持功能一致
发现代码异味需进行小步重构
需要将重构工作与新功能开发分离
npx skills add ciembor/agent-rules-books --skill refactoring -g -y
该 Skill 用于指导生产环境可靠性设计，涵盖故障处理、超时重试、熔断器、可观测性及部署行为。旨在应用 Nygard 原则提升系统稳定性与运维就绪度。
设计生产级容错机制
配置超时与重试策略
实现熔断器与背压
优化部署与可观测性
npx skills add ciembor/agent-rules-books --skill release-it -g -y
提供基于《程序员修炼之道》的工程实践指导，涵盖DRY、自动化、快速反馈及适应性设计等原则，辅助进行代码决策与架构权衡。
需要进行工程决策或架构权衡时
应用DRY原则或优化自动化流程时
提升代码适应性与反馈速度时
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
