MCP HubMCP Hub
Retour aux compétences

assess-form

pjt222
Mis à jour 2 days ago
7 vues
17
2
17
Voir sur GitHub
Autregeneral

À propos

Cette compétence évalue la forme architecturale actuelle d'un système, identifie les pressions de transformation et classe l'aptitude au changement. Elle réalise un inventaire structurel, une cartographie des pressions, une évaluation de la rigidité et une estimation de la capacité de changement. Utilisez-la avant des modifications architecturales majeures, lorsque les systèmes semblent bloqués, ou pour des bilans de santé périodiques des systèmes de longue durée.

Installation rapide

Claude Code

Recommandé
Principal
npx skills add pjt222/agent-almanac -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternatif
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/assess-form

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

评估形态

评估系统当前的结构形态——其架构、刚性、压力点和变化容量——以在启动变形之前确定转型准备度。

适用场景

  • 在任何重大架构变更之前,了解起点
  • 当系统感觉"卡住"但原因不明时
  • 当外部压力(增长、市场变化、技术债务)不断增加但响应方式不确定时
  • 评估在当前形态下提议的转型是否可行
  • 长期系统的周期性健康检查(年度形态评估)
  • adapt-architecture 配合使用——先评估,再转型

输入

  • 必需:要评估的系统(代码库、组织、基础设施、流程)
  • 可选:提议的转型方向(系统可能需要变成什么?)
  • 可选:已知的痛点或压力来源
  • 可选:之前的转型尝试及其结果
  • 可选:潜在转型的时间范围
  • 可选:可用于转型工作的资源

步骤

第 1 步:清点当前形态

不带判断地编目系统的结构要素——在评估之前先了解存在什么。

  1. 映射结构组件:
    • 模块:不同的功能单元(服务、团队、包、部门)
    • 接口:模块如何连接(API、协议、合约、汇报关系)
    • 数据流:信息如何在系统中流动
    • 依赖关系:什么依赖什么(直接、传递、循环)
    • 承重结构:其他一切都依赖的组件
  2. 记录形态的年龄和历史:
    • 每个主要组件是什么时候引入的?
    • 哪些组件最近发生了变化,哪些保持不变?
    • "地质层"结构是什么(旧核心、较新的添加、近期的补丁)?
  3. 识别形态的"骨架"与"血肉":
    • 骨架:改变代价极高的结构性决策(语言、数据库、部署模型)
    • 血肉:更容易改变的功能性决策(业务逻辑、UI、配置)
Structural Inventory Template:
┌──────────────┬──────────┬────────────┬───────────────────┬──────────┐
│ Component    │ Age      │ Last       │ Dependencies      │ Type     │
│              │          │ Modified   │ (in / out)        │          │
├──────────────┼──────────┼────────────┼───────────────────┼──────────┤
│ Auth service │ 3 years  │ 6 months   │ In: 12 / Out: 3  │ Skeleton │
│ Dashboard UI │ 1 year   │ 2 weeks    │ In: 2 / Out: 5   │ Flesh    │
│ Data pipeline│ 4 years  │ 1 year     │ In: 3 / Out: 8   │ Skeleton │
│ Config store │ 2 years  │ 3 months   │ In: 0 / Out: 15  │ Skeleton │
└──────────────┴──────────┴────────────┴───────────────────┴──────────┘

预期结果: 一份完整的结构清单,展示组件、年龄、修改时间、依赖关系概况,以及骨架或血肉的分类。这是当前形态的"X光片"。

失败处理: 如果清单不完整(组件未知或未记录),这本身就是一个发现——形态具有不透明性,这是一种转型风险。记录你能记录的,标记未知项,并为缺口规划发现工作。

第 2 步:映射转型压力

识别推动系统变化的力量和抵抗变化的力量。

  1. 编目外部压力(要求变化的力量):
    • 增长压力:当前形态无法处理不断增加的负载
    • 市场压力:竞争对手或用户要求当前形态不支持的能力
    • 技术压力:底层技术正在变得过时或不受支持
    • 监管压力:当前形态不满足的合规要求
    • 集成压力:必须与当前形态设计时未考虑的系统连接
  2. 编目内部压力(来自内部要求变化的力量):
    • 技术债务:拖慢开发速度的累积捷径
    • 知识集中:关键知识由太少的人掌握
    • 士气压力:团队对当前形态的挫败感
    • 运营负担:维护成本消耗了本应用于开发的资源
  3. 编目阻力(反对变化的力量):
    • 惯性:现有形态"够用"
    • 依赖锁定:太多东西依赖当前形态
    • 知识损失风险:转型可能摧毁机构知识
    • 成本:转型需要不确定回报的投资
    • 恐惧:之前的转型尝试失败了

预期结果: 一幅展示作用在系统上的力量方向和大小的压力图。如果转型压力显著超过阻力,转型已经过迟。如果阻力显著超过压力,在首先降低阻力之前转型将会失败。

失败处理: 如果压力映射产生了平衡的图景(既没有强压力也没有强阻力),系统可能不需要转型——或者分析过于表面。深入挖掘:访谈利益相关者,测量具体痛点,向前投射 12-18 个月。哪些压力会加剧?

第 3 步:评估结构刚性

确定当前形态有多灵活或刚性——它能弯曲,还是会断裂?

  1. 测试接口灵活性:
    • 模块能否在不引起级联变更的情况下被替换?(松耦合 = 灵活)
    • 接口是否定义良好且稳定?(合约清晰度 = 灵活)
    • 存在多少"上帝模块"(所有东西都依赖的模块)?(集中度 = 刚性)
  2. 测试数据灵活性:
    • 数据迁移是否简单直接?(模式演化工具、版本控制)
    • 数据格式是标准化的还是定制的?(定制 = 刚性)
    • 业务逻辑与数据结构的纠缠程度?(纠缠 = 刚性)
  3. 测试流程灵活性:
    • 团队能否快速发布变更?(部署管道健康度)
    • 测试套件是否全面?(变更的安全网)
    • 存在多少"不要碰"的组件?(禁区 = 刚性)
  4. 计算刚性评分:
Rigidity Assessment:
┌──────────────────────┬─────┬──────────┬──────┬──────────────────────┐
│ Dimension            │ Low │ Moderate │ High │ Your Assessment      │
├──────────────────────┼─────┼──────────┼──────┼──────────────────────┤
│ Interface coupling   │ 1   │ 2        │ 3    │ ___                  │
│ God module count     │ 1   │ 2        │ 3    │ ___                  │
│ Data entanglement    │ 1   │ 2        │ 3    │ ___                  │
│ Deployment friction  │ 1   │ 2        │ 3    │ ___                  │
│ Test coverage gaps   │ 1   │ 2        │ 3    │ ___                  │
│ "Don't touch" zones  │ 1   │ 2        │ 3    │ ___                  │
├──────────────────────┼─────┴──────────┴──────┼──────────────────────┤
│ Total (max 18)       │ 6-9: flexible         │ ___                  │
│                      │ 10-13: moderate        │                      │
│                      │ 14-18: rigid           │                      │
└──────────────────────┴───────────────────────┴──────────────────────┘

预期结果: 一个量化转型将遭遇多少结构性阻力的刚性评分。灵活的系统(6-9)可以渐进式转型。刚性的系统(14-18)在重建之前需要先溶解(见 dissolve-form)。

失败处理: 如果刚性评估不确定(中等评分但不清楚真正的问题在哪里),关注评分最高的维度。一个系统可能整体灵活,但有一个极其刚性的组件阻碍了转型。专门针对该组件。

第 4 步:估算变化容量

评估系统(和团队)吸收和执行转型的能力。

  1. 可用的转型能量:
    • 团队容量的百分之多少可以分配给转型?
    • 是否有组织支持(预算、授权、耐心)?
    • 是否具备正确的技能(架构、迁移、测试)?
  2. 变化吸收率:
    • 系统在不失稳的情况下每个时间单位能吸收多少变化?
    • 重大变更后的恢复时间是多少?
    • 是否有用于渐进式转型的暂存/金丝雀机制?
  3. 转型经验:
    • 团队之前是否成功转型过类似系统?
    • 是否有转型工具和实践(特性开关、绞杀者模式、蓝绿部署)?
    • 团队的风险容忍度是多少?
  4. 计算变化容量:
    • 高容量:专职团队、强工具链、先前经验、组织支持
    • 中等容量:兼职分配、部分工具、有限经验
    • 低容量:无专职资源、无工具、无经验、组织抵抗

预期结果: 一份变化容量评估,指出系统/团队在当前资源、技能和组织支持下能否执行提议的转型。

失败处理: 如果变化容量低但转型压力高,首先需要转型的不是系统——而是团队的能力。在尝试架构转型之前,投资于工具、培训和组织认同。

第 5 步:分类转型准备度

将压力、刚性和容量评估合并为一个准备度分类。

  1. 在准备度矩阵上定位系统:
Transformation Readiness Matrix:
┌─────────────────┬────────────────────────┬────────────────────────┐
│                  │ Low Rigidity           │ High Rigidity          │
├─────────────────┼────────────────────────┼────────────────────────┤
│ High Pressure   │ READY — Transform now  │ PREPARE — Reduce       │
│ + High Capacity │ using adapt-architecture│ rigidity first, then   │
│                 │                        │ use dissolve-form       │
├─────────────────┼────────────────────────┼────────────────────────┤
│ High Pressure   │ INVEST — Build capacity│ CRITICAL — Invest in   │
│ + Low Capacity  │ first, then transform  │ capacity AND reduce    │
│                 │                        │ rigidity before change │
├─────────────────┼────────────────────────┼────────────────────────┤
│ Low Pressure    │ OPTIONAL — Transform   │ DEFER — No urgency,    │
│ + Any Capacity  │ if strategic value is  │ monitor pressure and   │
│                 │ clear, otherwise defer │ reassess quarterly     │
└─────────────────┴────────────────────────┴────────────────────────┘
  1. 记录准备度分类,包括:
    • 分类标签(READY / PREPARE / INVEST / CRITICAL / OPTIONAL / DEFER)
    • 每个评估维度的关键发现
    • 建议的下一步
    • 可能改变分类结果的风险因素
  2. 如果 READY:继续使用 adapt-architecture
  3. 如果 PREPARE:继续使用 dissolve-form 降低刚性
  4. 如果 INVEST:构建能力(培训、工具、组织支持),然后重新评估
  5. 如果 CRITICAL:同时解决容量和刚性问题(可能需要外部帮助)
  6. 如果 OPTIONAL/DEFER:记录评估结果并设定重新评估日期

预期结果: 一个清晰、有据可依的转型准备度分类,附有具体的下一步。分类结果使得关于何时以及如何转型的知情决策成为可能。

失败处理: 如果分类不明确(例如中等压力、中等刚性、中等容量),默认为 PREPARE——在监控压力的同时渐进式降低刚性。这无论最终是否需要完全转型,都能构建能力并降低风险。

验证清单

  • 结构清单已完成,包含组件、年龄、依赖关系和类型
  • 转型压力已映射(外部、内部、阻力)
  • 刚性评分已在所有维度上计算
  • 变化容量已评估(资源、吸收率、经验)
  • 准备度分类已确定并附有合理推理
  • 已根据分类结果记录下一步
  • 已设定重新评估日期(即使当前为 READY)

常见问题

  • 仅评估技术系统:转型准备度包括组织准备度。一个技术上灵活但团队组织上刚性的系统仍然会转型失败
  • 过于乐观的容量估算:团队在维持正常运营的同时,一贯高估其变化容量。使用声称容量的 50% 作为现实估算
  • 忽视阻力:仅编目变化力量的压力映射会遗漏将减缓或阻止转型的阻力。阻力通常比看起来更强
  • 评估瘫痪:形态评估应该花费数小时到数天,而不是数周。如果花费太长时间,说明系统过于复杂而无法完全评估——在更高的抽象层次评估并深入问题区域
  • 混淆刚性与稳定性:刚性系统不等于稳定系统。稳定性来自精心设计的灵活性;刚性是设计灵活性的缺失

相关技能

  • adapt-architecture — 主要转型技能;assess-form 确定对其的准备度
  • dissolve-form — 对于分类为 PREPARE 或 CRITICAL 的系统,在转型前降低刚性
  • repair-damage — 对于需要在评估有意义之前先修复的系统
  • shift-camouflage — 表面层适应,可能无需完全转型即可缓解压力
  • forage-resources — 当问题是"我们应该变成什么"时,资源探索为形态评估提供信息
  • review-software-architecture — 用于详细技术架构评估的互补技能
  • assess-context — AI 自我应用变体;将结构评估映射到推理上下文的可塑性、刚性映射和转型准备度

Dépôt GitHub

pjt222/agent-almanac
Chemin: i18n/zh-CN/skills/assess-form
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Compétences associées

llamaguard

Autre

LlamaGuard est le modèle de Meta, doté de 7 à 8 milliards de paramètres, conçu pour modérer les entrées et sorties des LLM selon six catégories de sécurité comme la violence et les discours haineux. Il offre une précision de 94 à 95 % et peut être déployé avec vLLM, Hugging Face ou Amazon SageMaker. Utilisez cette compétence pour intégrer facilement le filtrage de contenu et des garde-fous de sécurité dans vos applications d'IA.

Voir la compétence

cost-optimization

Autre

Cette compétence de Claude aide les développeurs à optimiser les coûts du cloud grâce au redimensionnement des ressources, aux stratégies d'étiquetage et à l'analyse des dépenses. Elle fournit un cadre pour réduire les dépenses cloud et mettre en œuvre une gouvernance des coûts sur AWS, Azure et GCP. Utilisez-la lorsque vous devez analyser les coûts d'infrastructure, redimensionner les ressources ou respecter des contraintes budgétaires.

Voir la compétence

quantizing-models-bitsandbytes

Autre

Cette compétence quantifie les LLMs en précision 8 bits ou 4 bits à l'aide de bitsandbytes, permettant une réduction de 50 à 75 % de la mémoire utilisée avec une perte de précision minime. Elle est idéale pour exécuter des modèles plus volumineux sur une mémoire GPU limitée ou pour accélérer l'inférence, prenant en charge des formats comme INT8, NF4 et FP4. La compétence s'intègre à HuggingFace Transformers et permet l'entraînement QLoRA ainsi que l'utilisation d'optimiseurs en 8 bits.

Voir la compétence

dispatching-parallel-agents

Autre

Cette compétence Claude déploie plusieurs agents pour enquêter et résoudre simultanément 3 problèmes indépendants ou plus. Elle est conçue pour des scénarios impliquant des défaillances non liées qui peuvent être résolues sans état partagé ni dépendances. La capacité fondamentale est la résolution de problèmes en parallèle, en assignant un agent par domaine problématique indépendant afin de maximiser l'efficacité.

Voir la compétence