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 分講、書文)
- 可:前教試與何不行
- 可:人於題之自舒級(深專對新學)
行
一:察——解教戰
構容前解教境之全。
- 問所教與何故:「何概當中、不中則何發?」
- 識眾:「將釋於誰?已知何?」
- 察人自解:知題深足以教乎?(否則先薦
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 之部甚效、因...」
- 識最大改機(非諸患——焦一二)
- 薦具替:「勿言 [繁版]、試:[簡版]」
- 察知咒:何處其專使之跳眾所需步?
- 察眾配:深於眾否?淺/深?
- 用類→察類準(誤類劣於無類)
- 請再釋精段試改
得:定饋使釋可量改。人覺首二試之差。饋構建——何作、非唯何避。
敗:人於饋防→改「此不明」為「眾或不隨此——如何更明?」精版不勝→問或構(步二)非表——歸綱。
五:交——教中支
教即時→交中支。
- 活講:助前備可能問之答
- 文:覆書版於明、構、眾配
- 助備「不知」之刻:「若問汝不能答、言:『好問——將察而後答。』恆可。」
- 鼓交:助備察問予眾
- 備復計:眾迷、倦、或越釋時何作
- 交中導→予簡具促(「此處慢」「彼似惑——察」)
得:人覺備而支。有可能問之答、不期境之策、信不知諸事可。
敗:憂為主阻→直理:備減憂、認緊於眾常生接。式不定→助受式而適、勿控境。
六:思——析何成
教事後、導思以續改。
- 問:「何成?汝以何為傲?」
- 問:「何處察眾最入、最不入?」
- 問:「眾之應何驚?」
- 問:「若可改一事、為何?」
- 接思於則:「成之部用 [技]。可廣施。」
- 識下次一具改標
- 慶成:教為練增之技
得:人得具見於教效——非泛感、為何成何故之具察。離以下次一可施改。
敗:唯見負→引至成具刻。唯見正→輕探眾惑域。無思(即進)→記思為最久改處——縱 5 分覆亦重。
驗
- 構前察教戰(眾、式、限)
- 識核訊、構繞之
- 人於交前至少練釋一次
- 饋具、可施、致可量改
- 人備問、不確、眾適
- 後交思識至少一具改於下
- 導全程鼓——教難當認
忌
- 導容、非導教:助學材而非助講之。需學→先用
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 또는 모바일 환경 전환 시 세션 상태와 컨텍스트를 관리하여 워크플로를 최적화합니다. 다양한 단계에서 서로 다른 도구가 필요한 복잡한 프로젝트에 사용하세요.
