Agent skill

principle-soc

实现关注点分离，确保不同职责模块化和边界清晰。当需要架构分层设计、模块职责划分、横切关注点处理时使用。覆盖层次分离、功能分离、横切关注点三大维度，提供分离检查清单和耦合问题的诊断修复方法。

View SKILL.md on GitHub Repository
Stars 5
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/tikazyq/agentic-spec-forge/tree/main/AGENTIC_SPEC_FORGE/spec_stage_skill/common_advanced/principle-soc

SKILL.md

Separation of Concerns Skill

Scope: COMMON（全阶段通用）

版本: 0.1.0（占位）| 创建日期: 2025-11-27

概述

SoC（Separation of Concerns）是软件架构的基础原则：

┌─────────────────────────────────────────────────────┐
│              🧩 Separation of Concerns              │
├─────────────────────────────────────────────────────┤
│  "Let me not be so vain to think that I am the     │
│   sole author of my work... We are all but         │
│   standing on the shoulders of giants."            │
│                              — Edsger W. Dijkstra  │
└─────────────────────────────────────────────────────┘

关注点分离维度

层次分离

  • 表现层 / 业务层 / 数据层 清晰分离
  • UI 不包含业务逻辑
  • 数据访问不混入业务规则

功能分离

  • 每个模块有明确的职责边界
  • 模块间通过接口通信
  • 跨模块依赖最小化

横切关注点

  • 日志、安全、事务等是否独立处理
  • 是否使用 AOP 或中间件
  • 基础设施代码与业务代码分离

数据与行为分离

  • DTO/Entity 职责清晰
  • 数据传输与业务对象分离
  • 配置与代码分离

常见模式

模式 关注点分离方式
MVC/MVVM Model / View / Controller
分层架构 Presentation / Business / Data
微服务 按业务域分离
六边形架构 核心 / 端口 / 适配器

分级检查策略

L1-STREAMLINED

  • 每维度检查 1 个核心点（共 4 项）
  • 关注明显的职责混淆
  • 通过标准：4 项中 3 项通过（≥75%）

L2-BALANCED

  • 每维度检查 2-3 个关键点（共 8-12 项）
  • 依赖图可视化分析
  • 通过标准：8 项中 7 项通过（≥87.5%）

L3-RIGOROUS

  • 全面检查所有子项（12+ 项）
  • 耦合度量化（目标：低耦合高内聚）
  • 记录边界违反和重构建议
  • 通过标准：12 项中 11 项通过（≥91.7%）

>> 命令

>>soc_check_l1       # SoC 快速检查
>>soc_layer_review   # 层次分离审查
>>soc_boundary       # 边界识别

相关 Skills

  • 同类: principle-solid, principle-dry, principle-kiss（设计原则家族）
  • 应用: layer-design, component-boundary（架构分离）
  • 验证: vertical-slice（每个切片的关注点）
  • 扩展: microservice-thinking（微服务级别的 SoC）

TODO: 待细化各架构模式的 SoC 检查规则

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

tikazyq/agentic-spec-forge

code-review

执行代码审查流程（提交PR→自查→同行审查→反馈修改→合并），覆盖功能正确性、代码质量、测试完整性、安全合规四大维度。当提交Pull Request、进行结对编程、执行代码走查、需要知识共享时使用。支持L1/L2/L3三级审查深度。

5 1
Explore
tikazyq/agentic-spec-forge

code-quality

执行代码质量门禁检查（测试通过→覆盖率→Lint→GOAL追溯→可提交），验证单元测试覆盖率≥80%、集成测试通过率≥95%、代码规范零错误。当完成代码实现、准备提交代码、需要质量验证、进行提交前自检时使用。确保代码可合并。

5 1
Explore
tikazyq/agentic-spec-forge

tdd-cycle

执行 TDD 红绿重构循环（RED→GREEN→REFACTOR→REPEAT），通过先写失败测试、最小代码实现、保持绿色重构的节奏驱动开发。当启动功能开发、需要测试驱动节奏、进行迭代编码、追求高测试覆盖率时使用。提供检查清单和节奏控制。

5 1
Explore
tikazyq/agentic-spec-forge

refactoring

执行代码重构（识别坏味道→选择手法→小步修改→运行测试），在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。

5 1
Explore
tikazyq/agentic-spec-forge

arch-options-compare

比较多个架构方案（单体/微服务等），从SOLID原则、成本、复杂度等维度评分，生成对比表和推荐方案。当需要向客户解释架构选择或ADR决策时使用。

5 1
Explore
tikazyq/agentic-spec-forge

dev-tech-view-supplement

根据设计补充Dev视角的技术细节（数据库/API/通信协议），帮助Dev快速进入实施。当L1/L2设计缺乏技术细节、或准备向Dev交付前使用。

5 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results