assess-form
について
このスキルは、大規模な変更を実施する前に、システムのアーキテクチャ形態を評価し、変革への準備状態を測定します。構造インベントリ、プレッシャーポイント、硬直性、変化許容度を分析し、システムが変態に対してどの程度準備が整っているかを分類します。システムが行き詰まりを感じた時、大規模なリファクタリングの前、あるいは長期間運用されているシステムの定期的な健全性チェックとしてご利用ください。
クイックインストール
Claude Code
推奨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-formこのコマンドをClaude Codeにコピー&ペーストしてスキルをインストールします
ドキュメント
察形
察系當前結構之形——其架構、剛、壓點、變之能——以定啟蛻前之備。
用時
- 重架構變前解起點乃用
- 系覺「滯」而因不明乃用
- 外壓(長、市變、技債)積而應不定乃用
- 估擬之蛻於當前形可行乎乃用
- 長壽系之期察(年察形)乃用
- 補
adapt-architecture——先察後蛻乃用
入
- 必要:待察之系(碼庫、組織、基、程)
- 可選:擬之蛻向(系或當為何?)
- 可選:已知之痛點或壓源
- 可選:前蛻之試與果
- 可選:潛蛻之時限
- 可選:蛻之可得資源
法
第一步:錄當前之形
錄系結構之元而不評——解所存而後評之。
- 映結構元:
- 模:別功單(服、隊、包、部)
- 界:模如何連(API、協、約、匯報線)
- 數流:信息於系如何動
- 依:何依於何(直、遞、環)
- 承載結構:諸他皆依之元
- 書形之齡與史:
- 各主元何時引?
- 何元近變、何元靜?
- 「地層」構(老核、新增、近補)為何?
- 識形之「骨」於「肉」:
- 骨:極費以變之結構決(語、庫、部署)
- 肉:易變之功決(業邏、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 月。何壓將增?
第三步:察結構剛
定當前形柔剛——能曲乎、將崩乎?
- 試界柔:
- 模可易換不連變乎?(鬆耦 = 柔)
- 界明定穩乎?(約明 = 柔)
- 幾「神模」(諸依之模)?(集中 = 剛)
- 試數柔:
- 數遷順乎?(模演具、版控)
- 數式標乎、特乎?(特 = 剛)
- 業邏與數構纏乎?(纏 = 剛)
- 試程柔:
- 隊可速發變乎?(部署管健)
- 試套全乎?(變之安網)
- 幾「勿觸」元?(禁區 = 剛)
- 算剛分:
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)。
敗則: 若剛察歧(中分而不清真患何),注最高維。系可整柔而有一極剛元阻蛻。目此元。
第四步:估變能
察系(與隊)收行蛻之能。
- 可得蛻能:
- 隊能幾割分於蛻?
- 有組織支(預算、授權、耐)乎?
- 正技(架構、遷、試)可得乎?
- 變吸率:
- 系每時可吸幾變而不穩?
- 重變後復時?
- 有漸蛻之備/灰機制乎?
- 蛻經:
- 隊曾成蛻類系乎?
- 蛻具與實(功能旗、絞榕、藍綠)存乎?
- 隊之險容?
- 算變能:
- 高能:專隊、強具、前經、組織支
- 中能:部分分、些具、限經
- 低能:無專資、無具、無經、抗之組織
得: 變能察示系/隊能依當前資、技、組織支行擬蛻乎。
敗則: 若變能低而蛻壓高,首蛻非系——乃隊能也。投具、訓、組織認可於試架構蛻前。
第五步:分蛻備
合壓、剛、能察為備分類。
- 繪系於備矩:
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)
陷
- 只察技系:蛻備含組織備。技柔系而組織剛隊仍敗於蛻
- 樂觀能估:隊恆估其變能過高而守常運。以宣能之半為實估
- 忽抗力:只錄變力之壓映失將緩或止蛻之抗。抗常強於所顯
- 察癱:形察宜時至日,非週。若過久,系過繁不可全察——於高抽察而深入問區
- 混剛於穩:剛系非穩系。穩來於良設之柔;剛為無設之柔
參
adapt-architecture— 主蛻技;assess-form 定備dissolve-form— PREPARE 或 CRITICAL 之系蛻前減剛repair-damage— 察前需修之系shift-camouflage— 表級適或解壓無需全蛻forage-resources— 資源探啟「當為何」之形察review-software-architecture— 詳技架構評之補assess-context— AI 自用之變;映結構察於推境之可塑、剛映、蛻備
GitHub リポジトリ
関連スキル
executing-plans
デザインexecuting-plansスキルは、完全な実装計画があり、それを管理されたバッチでレビューチェックポイントを設けながら実行する場合に使用します。このスキルは計画を読み込んで批判的にレビューした後、小さなバッチ(デフォルトは3タスク)でタスクを実行し、各バッチの間に進捗状況を報告してアーキテクトのレビューを受けます。これにより、品質管理チェックポイントが組み込まれた体系的な実装が保証されます。
requesting-code-review
デザインこのスキルは、コードレビュアーサブエージェントを起動し、処理を進める前に要件に対してコード変更を分析します。タスク完了後、主要な機能の実装後、またはmainブランチへのマージ前などに使用すべきです。このレビューは、現在の実装と元の計画を比較することで、問題を早期に発見するのに役立ちます。
connect-mcp-server
デザインこのスキルは、開発者がHTTP、stdio、またはSSEトランスポートを使用してMCPサーバーをClaude Codeに接続するための包括的なガイドを提供します。GitHub、Notion、カスタムAPIなどの外部サービスを統合するためのインストール、設定、認証、セキュリティについて解説しています。MCP統合のセットアップ、外部ツールの設定、またはClaudeのModel Context Protocolを扱う際にご利用ください。
web-cli-teleport
デザインこのスキルは、タスク分析に基づいて開発者がClaude Code WebとCLIインターフェースの選択を支援し、これらの環境間でのシームレスなセッションテレポーテーションを可能にします。Web、CLI、モバイル環境を切り替える際のセッション状態とコンテキストを管理することで、ワークフローを最適化します。様々な段階で異なるツールを必要とする複雑なプロジェクトにご活用ください。
