assess-form
À propos
Cette compétence évalue la forme architecturale d'un système, en cartographiant la rigidité structurelle et les pressions de transformation afin de classifier sa préparation au changement. Elle fournit un inventaire structurel, évalue la capacité d'évolution, et est conçue pour être utilisée avant des changements architecturaux majeurs ou lorsqu'un système semble bloqué. Les développeurs doivent l'utiliser comme un diagnostic de santé pour comprendre le point de départ avant d'entreprendre une métamorphose significative.
Installation rapide
Claude Code
Recommandénpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/assess-formCopiez et collez cette commande dans Claude Code pour installer cette compétence
Documentation
評形
評系統當前之結構形——其架構、剛性、壓力點、變動之能——以於蛻變起始前判轉化就緒。
適用時機
- 任何顯著建築變更前以解起點
- 系統覺「卡」然因不明
- 外部壓力(成長、市場移、技術債)積而應對不確
- 評所提之轉化於當前形下可行否
- 久存系統之定期健康查(年度形評)
- 補
adapt-architecture——先評後轉
輸入
- 必要:欲評之系統(碼庫、組織、基礎設施、流程)
- 選擇性:所提之轉化方向(系統或須化為何?)
- 選擇性:已知之痛點或壓力源
- 選擇性:先前轉化嘗試與其結果
- 選擇性:潛在轉化之時間範圍
- 選擇性:可用於轉化努力之資源
步驟
步驟一:清點當前形
不評斷地將系統之結構元素編目——評之前先解其存。
- 對應結構元件:
- 模組:獨之功能單元(服務、團隊、套件、部門)
- 介面:模組如何連(API、協定、契約、報告線)
- 資料流:資訊如何於系統中移
- 依賴:何依何(直接、傳遞、循環)
- 承重結構:他一切所依之元件
- 記形之齡與史:
- 各主元件何時引?
- 何元件近期變 vs. 仍靜?
- 「地質層」結構為何(舊核、新增、近補)?
- 辨形之「骨」與「肉」:
- 骨:變之極繁之結構決策(語言、資料庫、部署模型)
- 肉:較易變之功能決策(業務邏輯、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 光」。
失敗時: 若清單不全(元件未知或無記載),此本身為發現——形有不透明,乃轉化之險。記可記者,標未知,並計畫為缺發現。
步驟二:對應轉化壓力
辨推系統向變之力與抗之力。
- 列外部壓力(求變之力):
- 成長壓:當前形不能應增載
- 市場壓:競爭或使用者求當前形不能支之能
- 技術壓:底層技術漸過時或不支
- 法規壓:當前形不合之合規要求
- 整合壓:須與當前形未為其設計之系統連
- 列內部壓力(自內求變之力):
- 技術債:累積之捷徑緩開發
- 知識集中:關鍵知識為過少人持
- 士氣壓:團隊對當前形之挫
- 運營負擔:維護成本耗本應投開發之資源
- 列抗力(反變之力):
- 慣性:既有形「足以」工
- 依賴鎖定:過多事依當前形
- 知識失之險:轉化或毀機構知識
- 成本:轉化需投資而回報不確
- 懼:先前轉化嘗試失敗
預期: 壓力圖呈對系統之力之向與量。若轉化壓力顯超抗力,轉化逾時。若抗力顯超壓力,轉化將失敗,須先減抗力。
失敗時: 若壓力對應產平衡之圖(壓力與抗力皆不強),系統或不需轉化——或分析為表面。深掘:訪利害關係人、量特定痛點、向前投 12-18 月。何壓力將強?
步驟三:評結構剛性
判當前形之彈或剛——能彎,抑或將斷?
- 試介面彈性:
- 模組可換而無連動變更否?(鬆耦合 = 彈)
- 介面定義良好且穩否?(契約清 = 彈)
- 存幾「神模組」(一切所依之模組)?(集中 = 剛)
- 試資料彈性:
- 資料遷移直截否?(schema 演進工具、版本控制)
- 資料格式標準或客製?(客製 = 剛)
- 業務邏輯與資料結構糾纏多深?(糾纏 = 剛)
- 試流程彈性:
- 團隊可速出貨變更否?(部署管線健康)
- 測試套件全否?(變動之安全網)
- 存幾「勿觸」元件?(禁區 = 剛)
- 計算剛性分:
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)。
失敗時: 若剛性評估不確(中分而真問題不清),重於分最高之維。系統可整體彈而有一極剛元件阻轉化。針對該元件特行。
步驟四:估變動之能
評系統(與團隊)吸納並執行轉化之能。
- 可用之轉化能量:
- 團隊能配多少百分比於轉化?
- 有組織支持否(預算、授權、耐心)?
- 有合適技能否(架構、遷移、測試)?
- 變動吸納率:
- 系統每時可吸納多少變動而不失穩?
- 顯著變動後之復原時為何?
- 有 staging/canary 機制以漸進轉化否?
- 轉化經驗:
- 團隊曾成功轉化類系統否?
- 有轉化工具與實踐就位否(特性旗標、絞殺榕、blue-green)?
- 團隊之風險容忍為何?
- 計算變動之能:
- 高能:專團、強工具、先前經驗、組織支持
- 中能:兼職配置、有些工具、有限經驗
- 低能:無專資源、無工具、無經驗、抗組織
預期: 變動之能評估,示系統/團隊以當前資源、技能、組織支持是否能執所提轉化。
失敗時: 若變動之能低而轉化壓力高,首要轉化非系統——而為團隊之能力。先投工具、訓練、組織共識,後試建築轉化。
步驟五:分類轉化就緒
合壓力、剛性、能評估為就緒分類。
- 將系統繪於就緒矩陣:
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 │
└─────────────────┴────────────────────────┴────────────────────────┘
- 記就緒分類附:
- 分類標籤(READY / PREPARE / INVEST / CRITICAL / OPTIONAL / DEFER)
- 各評估維之關鍵發現
- 建議下步
- 可改分類之風險因子
- 若 READY:進至
adapt-architecture - 若 PREPARE:進至
dissolve-form以減剛性 - 若 INVEST:建能(訓練、工具、組織支持),後重評
- 若 CRITICAL:同時應對能與剛性(或需外援)
- 若 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
Compétences associées
executing-plans
DesignUtilisez la compétence executing-plans lorsque vous disposez d'un plan de mise en œuvre complet à exécuter par lots contrôlés avec des points de contrôle de revue. Elle charge et examine le plan de manière critique, puis exécute les tâches par petits lots (3 tâches par défaut) tout en rapportant la progression entre chaque lot pour une revue par l'architecte. Cela garantit une mise en œuvre systématique avec des points de contrôle de qualité intégrés.
requesting-code-review
DesignCette compétence délègue un sous-agent réviseur de code pour analyser les modifications apportées au code par rapport aux exigences avant de poursuivre. Elle doit être utilisée après avoir terminé des tâches, implémenté des fonctionnalités majeures, ou avant une fusion vers la branche principale. La revue aide à détecter précocement les problèmes en comparant l'implémentation actuelle avec le plan initial.
connect-mcp-server
DesignCette compétence fournit un guide complet permettant aux développeurs de connecter des serveurs MCP à Claude Code via les transports HTTP, stdio ou SSE. Elle couvre l'installation, la configuration, l'authentification et la sécurité pour intégrer des services externes tels que GitHub, Notion et des API personnalisées. Utilisez-la lors de la configuration d'intégrations MCP, de la configuration d'outils externes ou du travail avec le Protocole de Contexte de Modèle de Claude.
web-cli-teleport
DesignCette compétence aide les développeurs à choisir entre les interfaces Web et CLI de Claude Code en fonction de l'analyse des tâches, puis permet une téléportation transparente des sessions entre ces environnements. Elle optimise le flux de travail en gérant l'état et le contexte de la session lors du passage entre le web, la CLI ou le mobile. Utilisez-la pour des projets complexes nécessitant différents outils à diverses étapes.
