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
指导在代码中实现领域驱动设计,涵盖聚合、事件、仓储及上下文集成等核心概念。
实现聚合边界与不变量
编写领域事件或仓储
构建应用服务或模块
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
指导在诊断代码异味、选择重构技术时应用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
指导在涉及生产可靠性、故障处理、超时重试、熔断器及部署行为时,遵循 Michael T. Nygard 原则进行设计决策,确保系统稳健性。
设计容错机制
配置重试策略
实现熔断器
优化部署流程
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


