Agent skill

arch-options-compare

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

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/design/arch-options-compare

SKILL.md

arch-options-compare: 架构方案对比

描述

比较 2-3 个架构方案(如单体/微服务/Serverless),从 SOLID 原则、成本、复杂度、团队技能等维度评分,生成对比表。

适用场景

  • WORKFLOW_STEP_4 Task S4-2 Round 1:用户提供多个技术选型方案时
  • WORKFLOW_STEP_4 Task S4-7:需要向客户解释为什么选择某个架构
  • L3 特定:ADR 记录架构决策时需要对比分析

输入

  • 2-3 个架构方案名称(如"单体 vs 微服务")
  • 当前项目上下文(SPEC_PRJ_DESC + requirements/)

输出

  • 对比表(markdown)
  • 推荐方案 + 理由
  • SOLID 原则支持度评分(每个原则 1-5 分)

执行策略

  1. 提取项目规模、团队技能、NFR 要求(从 requirements/ 的 NFR artifact)
  2. 对每个方案,评估:
    • 单一职责支持度(S)
    • 开闭原则支持度(O)
    • 里氏替换支持度(L)
    • 接口隔离支持度(I)
    • 依赖倒置支持度(D)
    • 成本(开发/运维)
    • 复杂度(学习曲线/维护难度)
    • 团队技能匹配度
  3. 生成对比表(5-7 个维度)
  4. 给出推荐方案 + 3-5 句理由(业务语言)

价值

  • SPEC 组织:为 ARCH/ADR 提供决策依据
  • PM/用户:理解技术选择的业务价值
  • Dev:明确架构决策的权衡

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

dev-tech-view-supplement

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

5 1
Explore
tikazyq/agentic-spec-forge

design-consistency-check

检查VS↔SD/DM一致性(value_path是否与序列图/数据模型匹配),生成不一致项清单和修复建议。当Self-Reflection报告一致性问题或准备CONSTRAINT验收前使用。

5 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results