teach-guidance
정보
`teach-guidance` 스킬은 개발자에게 기술 개념을 효과적으로 가르치고 설명하는 방법을 지도합니다. 이 스킬은 콘텐츠 구성, 다양한 청중에 맞춘 내용 수준 조정, 그리고 발표, 문서화, 멘토링에서의 명확성 향상에 대한 지침을 제공합니다. 발표 준비, 튜토리얼 작성, 동료 멘토링 시 설명 능력을 향상시키기 위해 이 스킬을 사용하세요.
빠른 설치
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/teach-guidanceClaude Code에서 이 명령을 복사하여 붙여넣어 스킬을 설치하세요
문서
教(引)
引人成更善之師、釋者、講者。AI 為教之師——助察何當傳於誰、構為清、練釋、依饋而精、支獻、思何成。
用時
- 須獻技內於眾而欲備之教練乃用
- 欲撰更善之文檔、教程、釋乃用
- 難釋念於異專階之人乃用
- 教或助初級開發者而欲更效乃用
- 備為講、研、知享乃用
learn-guidance助其獲知後,今須傳於他乃用
入
- 必要:所教或釋者(題、念、系、程)
- 必要:眾為何(專階、境、與其關)
- 可選:獻之格(演、文檔、一對一、研)
- 可選:時之限(5 分釋、30 分講、書文)
- 可選:前教之試與何不行
- 可選:其於題之自舒(深專 vs 新學)
法
第一步:察——解教之挑
構容前,解教之全境。
- 問所教與其因:「何念當落,若不落則何?」
- 識眾:「將釋於誰?其已知何?」
- 察人之自解:知題夠深以教乎?(若否,先薦
learn-guidance) - 識格:演、文、談、碼審、配對編
- 定成準:「何以知眾已解?」
- 顯懼或慮:「何處最令君憂?」
Teaching Challenge Matrix:
┌──────────────────┬──────────────────────────┬──────────────────────────┐
│ Challenge Type │ Indicators │ Focus Area │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Knowledge gap │ "I sort of know it │ Deepen their own under- │
│ │ but can't explain it" │ standing first (learn) │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Audience gap │ "I don't know what │ Build audience empathy │
│ │ they already know" │ and calibration │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Structure gap │ "I know it all but │ Organize content into │
│ │ don't know where to │ a narrative arc │
│ │ start" │ │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Confidence gap │ "What if they ask │ Practice and preparation │
│ │ something I can't │ for edge cases │
│ │ answer?" │ │
└──────────────────┴──────────────────────────┴──────────────────────────┘
得:教挑之明圖:何、與誰、以何格、何限、何處最不信。
敗則:若人不能述眾,助立人物:「想一具體之人聞此。其知何?所重何?」若不能述題,或須先深學。
第二步:構——組容為清
助人立明之敘構為其釋。
- 識單核訊:「若眾唯記一物,當為何?」
- 自核外建:核訊前須何境,後隨何細?
- 施倒金字塔:最要先,支細後
- 為技容,擇構之模:
- 念釋:何 → 何因 → 何如 → 例 → 邊例
- 教程:的 → 先決 → 步 → 驗 → 下步
- 構覽:問 → 限 → 解 → 權衡 → 所考之替
- 調試走:症 → 察 → 根因 → 修 → 防
- 確各節有清之的:若節不服核訊,刪之
- 計轉:「已覆 X。今於其上,須解 Y,蓋……」
得:構之提,諸元皆服核訊。構當感邏而必然——各節自引下節。
敗則:若構漸長,範圍太廣——助刪。若構感平(諸皆同層),階須精——識何主何支。若拒構(「我自然釋之」),注自然之釋於簡題行而於繁題敗——構乃架。
第三步:練——預演其釋
使人練釋念,AI 為眾。
- 求其如將實對眾而釋
- 首遍勿打斷——使其尋自然之流
- 注釋何處明何處惑
- 注用眾或不知之術之處
- 注略步或假眾或無之知之處
- 注於易部過久而於難部速過
- 若有時限,計時
得:初稿之釋,顯人之自然教模——可建之強與當調之習。練當感低賭:「此乃粗稿,非演也。」
敗則:若人僵或言「不知何始」,回第二步之構而使其一節一釋,非全。若過自批(「太爛」),轉為具:「實君釋 X 之法甚清——焦使 Y 同質。」
第四步:精——依饋改
獻具可行之饋於練之釋。
- 先強:「君以 Y 之類比釋 X 之處甚效,蓋……」
- 識最大改機(非諸患——焦一二)
- 獻具替:「勿言 [繁版],試:[簡版]」
- 察知之咒:其專使略眾所須之步乎?
- 察眾之校:深合眾,抑太淺太深?
- 若用類比,察其準(誤導之類比劣於無)
- 使其重釋精節以試改
得:的之饋,量改釋。人可覺一二試之異。饋為建構而陳——當為何,非僅當避。
敗則:若人於饋而防,自「此不明」轉為「眾或不隨——何以使更明?」若精版不善,問題或為構(第二步)非獻——回提綱。
第五步:獻——教中支
若教實時,獻獻中支。
- 為直播:助先備可能問之答
- 為文檔:審書版為清、構、眾校
- 助備「不知」之刻:「若被問不能答,言:『佳問——我察而後復。』恆可。」
- 鼓互:助備察問為眾
- 備復計:眾迷、悶、超釋之處何為
- 若獻中教練:獻簡具之催(「此處緩之」「其似惑——察之」)
得:人感備而支。有可能問之答、不期境之策、不全知亦可之信。
敗則:若憂為主礙,直治之:備減憂,認憂於眾常生連。若獻格屢變,助受格而適,非控境。
第六步:思——析何成
教事後,引思以續改。
- 問:「何成?以何為傲?」
- 問:「於何處覺眾最動?最不動?」
- 問:「眾之應有何驚?」
- 問:「若可變一物,當為何?」
- 連思於則:「成之部用 [術]。可廣施之。」
- 為下次識一具改的
- 慶其成:教乃技,以練而進
得:人得實見其教效——非泛感乃具察何成何因。離時有一可行改為下次。
敗則:若唯見負,轉至成之具刻。若唯見正,輕探眾惑之處。若無思(即過),注思乃最久之改之處——五分之審亦有義。
驗
- 教挑於構前已察(眾、格、限)
- 核訊已識而構繞之組
- 人已練釋至少一次方獻
- 饋具、可行、致量改
- 人已備為問、未確、眾適
- 獻後思識至少一具改為下次
- 教練全程鼓——教難當認
陷
- 教其容,非其教:助學材而非助獻。若須學,先用
learn-guidance。 - 過構:構過剛,失人之自然教聲。構當支其式,非代之。
- 完美陷:永練而不獻。某時練回減——推獻。
- 忽眾異:混眾須層之釋——核念為皆,細為專,類比為新。
- 饋過載:一獻過注壓人。焦最大衝之一二。
- 疏情備:教憂為實。治信與治容同要。
參
teach— AI 自為之變,校之知傳learn-guidance— 引人學;有效教之先決listen-guidance— 活聽之技助師實時應眾須meditate-guidance— 教事前定憂達焦
GitHub 저장소
연관 스킬
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 또는 모바일 환경 전환 시 세션 상태와 컨텍스트를 관리하여 워크플로를 최적화합니다. 다양한 단계에서 서로 다른 도구가 필요한 복잡한 프로젝트에 사용하세요.
