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
提供遵循罗伯特·C·马丁风格的代码规范,用于提升日常代码的可读性、命名、函数设计及职责划分。
优化代码可读性
改进命名规范
重构函数设计
明确代码职责
npx skills add ciembor/agent-rules-books --skill clean-code -g -y
基于 Steve McConnell 原则,指导例程、变量、类及控制流的规范实现与防御性编程。通过引用 mini.md 规则进行代码构建决策,确保编码质量与设计一致性。
需要遵循严格编码规范的代码实现
涉及防御性编程或代码标准检查的场景
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)实践指导,涵盖限界上下文、子域、聚合及战术建模,强调减少仪式化开销。适用于需要平衡架构严谨性与开发效率的复杂业务系统设计场景。
进行软件架构设计或重构时涉及领域模型划分
讨论或定义限界上下文与上下文映射关系
设计聚合根、值对象或领域事件等战术模式
npx skills add ciembor/agent-rules-books --skill domain-driven-design-distilled -g -y
用于复杂领域建模,定义界限上下文、保护通用语言及设计聚合根。触发场景包括战略设计、上下文映射、模型驱动设计及涉及聚合与仓储的设计决策。
进行复杂领域的战略建模
定义界限上下文和通用语言
设计聚合根、仓储或领域服务
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企业架构模式,指导选择应用层、服务层、领域模型、仓储等组件,辅助进行架构设计与代码决策。
涉及企业应用结构分层设计
需要选择服务层或领域模型模式
处理数据映射与集成模式
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
用于在保持行为不变的前提下改进代码结构,处理代码异味、小步重构及测试清理,将重构与功能变更分离。
需要改进现有代码结构但保持行为不变
识别和处理代码异味
执行基于测试的代码清理
需要将重构操作与功能开发分离
npx skills add ciembor/agent-rules-books --skill refactoring -g -y
指导在涉及生产可靠性、故障处理、超时重试、熔断器及部署行为时,应用 Michael T. Nygard 的设计规则,确保系统稳健性和运营就绪。
设计容错机制
配置超时与重试策略
实施熔断器模式
优化部署流程
npx skills add ciembor/agent-rules-books --skill release-it -g -y
应用《程序员修炼之道》中的实用编程原则,辅助工程判断、反馈循环、知识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


