MCP HubMCP Hub
스킬 목록으로 돌아가기

assess-form

pjt222
업데이트됨 Yesterday
1 조회
17
2
17
GitHub에서 보기
디자인general

정보

이 스킬은 시스템의 아키텍처 형태를 평가하여 구조적 경직성과 변화 압력을 매핑하고, 변화에 대한 준비도를 분류합니다. 구조적 인벤토리를 제공하고 변화 수용 능력을 평가하며, 주요 아키텍처 전환 전이나 시스템이 정체된 느낌을 받을 때 사용하도록 설계되었습니다. 개발자는 중대한 변형을 시도하기 전 시작점을 이해하기 위한 진단적 건강 점검으로 활용해야 합니다.

빠른 설치

Claude Code

추천
기본
npx skills add pjt222/agent-almanac -a claude-code
플러그인 명령대체
/plugin add https://github.com/pjt222/agent-almanac
Git 클론대체
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/assess-form

Claude Code에서 이 명령을 복사하여 붙여넣어 스킬을 설치하세요

문서

評形

評系統當前之結構形——其架構、剛性、壓力點、變動之能——以於蛻變起始前判轉化就緒。

適用時機

  • 任何顯著建築變更前以解起點
  • 系統覺「卡」然因不明
  • 外部壓力(成長、市場移、技術債)積而應對不確
  • 評所提之轉化於當前形下可行否
  • 久存系統之定期健康查(年度形評)
  • adapt-architecture——先評後轉

輸入

  • 必要:欲評之系統(碼庫、組織、基礎設施、流程)
  • 選擇性:所提之轉化方向(系統或須化為何?)
  • 選擇性:已知之痛點或壓力源
  • 選擇性:先前轉化嘗試與其結果
  • 選擇性:潛在轉化之時間範圍
  • 選擇性:可用於轉化努力之資源

步驟

步驟一:清點當前形

不評斷地將系統之結構元素編目——評之前先解其存。

  1. 對應結構元件:
    • 模組:獨之功能單元(服務、團隊、套件、部門)
    • 介面:模組如何連(API、協定、契約、報告線)
    • 資料流:資訊如何於系統中移
    • 依賴:何依何(直接、傳遞、循環)
    • 承重結構:他一切所依之元件
  2. 記形之齡與史:
    • 各主元件何時引?
    • 何元件近期變 vs. 仍靜?
    • 「地質層」結構為何(舊核、新增、近補)?
  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 光」。

失敗時: 若清單不全(元件未知或無記載),此本身為發現——形有不透明,乃轉化之險。記可記者,標未知,並計畫為缺發現。

步驟二:對應轉化壓力

辨推系統向變之力與抗之力。

  1. 列外部壓力(求變之力):
    • 成長壓:當前形不能應增載
    • 市場壓:競爭或使用者求當前形不能支之能
    • 技術壓:底層技術漸過時或不支
    • 法規壓:當前形不合之合規要求
    • 整合壓:須與當前形未為其設計之系統連
  2. 列內部壓力(自內求變之力):
    • 技術債:累積之捷徑緩開發
    • 知識集中:關鍵知識為過少人持
    • 士氣壓:團隊對當前形之挫
    • 運營負擔:維護成本耗本應投開發之資源
  3. 列抗力(反變之力):
    • 慣性:既有形「足以」工
    • 依賴鎖定:過多事依當前形
    • 知識失之險:轉化或毀機構知識
    • 成本:轉化需投資而回報不確
    • 懼:先前轉化嘗試失敗

預期: 壓力圖呈對系統之力之向與量。若轉化壓力顯超抗力,轉化逾時。若抗力顯超壓力,轉化將失敗,須先減抗力。

失敗時: 若壓力對應產平衡之圖(壓力與抗力皆不強),系統或不需轉化——或分析為表面。深掘:訪利害關係人、量特定痛點、向前投 12-18 月。何壓力將強?

步驟三:評結構剛性

判當前形之彈或剛——能彎,抑或將斷?

  1. 試介面彈性:
    • 模組可換而無連動變更否?(鬆耦合 = 彈)
    • 介面定義良好且穩否?(契約清 = 彈)
    • 存幾「神模組」(一切所依之模組)?(集中 = 剛)
  2. 試資料彈性:
    • 資料遷移直截否?(schema 演進工具、版本控制)
    • 資料格式標準或客製?(客製 = 剛)
    • 業務邏輯與資料結構糾纏多深?(糾纏 = 剛)
  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)。

失敗時: 若剛性評估不確(中分而真問題不清),重於分最高之維。系統可整體彈而有一極剛元件阻轉化。針對該元件特行。

步驟四:估變動之能

評系統(與團隊)吸納並執行轉化之能。

  1. 可用之轉化能量:
    • 團隊能配多少百分比於轉化?
    • 有組織支持否(預算、授權、耐心)?
    • 有合適技能否(架構、遷移、測試)?
  2. 變動吸納率:
    • 系統每時可吸納多少變動而不失穩?
    • 顯著變動後之復原時為何?
    • 有 staging/canary 機制以漸進轉化否?
  3. 轉化經驗:
    • 團隊曾成功轉化類系統否?
    • 有轉化工具與實踐就位否(特性旗標、絞殺榕、blue-green)?
    • 團隊之風險容忍為何?
  4. 計算變動之能:
    • 高能:專團、強工具、先前經驗、組織支持
    • 中能:兼職配置、有些工具、有限經驗
    • 低能:無專資源、無工具、無經驗、抗組織

預期: 變動之能評估,示系統/團隊以當前資源、技能、組織支持是否能執所提轉化。

失敗時: 若變動之能低而轉化壓力高,首要轉化非系統——而為團隊之能力。先投工具、訓練、組織共識,後試建築轉化。

步驟五:分類轉化就緒

合壓力、剛性、能評估為就緒分類。

  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 自應用變體;將結構評估對應於推理情境之可塑性、剛性對應、轉化就緒

GitHub 저장소

pjt222/agent-almanac
경로: i18n/wenyan-lite/skills/assess-form
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

연관 스킬

executing-plans

디자인

executing-plans 스킬은 검토 체크포인트가 포함된 통제된 배치로 실행할 완전한 구현 계획이 있을 때 사용합니다. 이 스킬은 계획을 불러와 비판적으로 검토한 후, 소규모 배치(기본값 3개 작업)로 작업을 실행하면서 각 배치 사이에 진행 상황을 아키텍트 검토를 위해 보고합니다. 이를 통해 내재된 품질 관리 체크포인트를 갖춘 체계적인 구현이 보장됩니다.

스킬 보기

requesting-code-review

디자인

이 스킬은 코드 변경 사항을 요구 사항에 따라 분석하기 위해 코드 리뷰어 하위 에이전트를 호출합니다. 작업 완료 후, 주요 기능 구현 후, 또는 메인 브랜치에 병합하기 전에 사용해야 합니다. 이 리뷰는 현재 구현체와 원래 계획을 비교하여 문제를 조기에 발견하는 데 도움이 됩니다.

스킬 보기

connect-mcp-server

디자인

이 스킬은 개발자들이 HTTP, stdio 또는 SSE 전송 방식을 통해 MCP 서버를 Claude Code에 연결하는 포괄적인 가이드를 제공합니다. GitHub, Notion 및 사용자 정의 API와 같은 외부 서비스를 통합하기 위한 설치, 구성, 인증 및 보안을 다룹니다. MCP 통합 설정, 외부 도구 구성 또는 Claude의 모델 컨텍스트 프로토콜 작업 시 활용하세요.

스킬 보기

web-cli-teleport

디자인

이 스킬은 작업 분석을 기반으로 개발자가 Claude Code 웹 인터페이스와 CLI 인터페이스 중 선택할 수 있도록 돕고, 두 환경 간 원활한 세션 텔레포트를 가능하게 합니다. 웹, CLI 또는 모바일 환경 전환 시 세션 상태와 컨텍스트를 관리하여 워크플로를 최적화합니다. 다양한 단계에서 서로 다른 도구가 필요한 복잡한 프로젝트에 사용하세요.

스킬 보기