Additional resources【免費下載鏈接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.項目地址: https://gitcode.com/GitHub_Trending/cl/claude-howtoFor complete API details, see reference.mdFor usage examples, see examples.md### 應做 - 使用清晰、描述性的名稱編寫全面指令添加具體示例 - 打包相關腳本與模板用真實場景測試記錄依賴。 ### 不應做 - 不要為一次性任務創建 Skill不要復制已有功能不要把 Skill 做得過寬 - 不要省略 description 字段不要未經審計就安裝不可信來源的 Skill。 ## 故障排除 ### 快速參考 | 問題 | 解決方案 | |------|----------| | Claude 不使用 Skill | 讓描述更具體加入觸發詞 | | 找不到 Skill 文件 | 核對路徑~/.claude/skills/name/SKILL.md | | YAML 報錯 | 檢查 --- 標記、縮進禁用 tab | | Skills 沖突 | 在描述中使用不同的觸發詞 | | 腳本不運行 | 檢查權限chmod x scripts/*.py | | Claude 看不到全部 Skills | 裝得太多運行 /context 查看警告 | ### Skill 不觸發 1. 檢查描述是否包含用戶會自然說出的關鍵詞 2. 驗證詢問 What skills are available? 時 Skill 出現 3. 嘗試改寫你的請求以匹配描述 4. 用 /skill-name 直接調用測試。 ### Skill 觸發過頻 1. 讓描述更具體 2. 加 disable-model-invocation: true 改為僅手動調用。 ### Claude 看不到所有 Skills Skill 描述按**上下文窗口的 2%** 加載fallback**16,000 字符**。運行 /context 檢查被排除 Skills 的警告用環境變量 SLASH_COMMAND_TOOL_CHAR_BUDGET 覆蓋預算。 ## 安全考慮 **只使用可信來源的 Skills。** Skill 通過指令和代碼賦予 Claude 能力——惡意 Skill 可能誘導 Claude 以有害方式調用工具或執行代碼。 - **徹底審計**審查 Skill 目錄中的所有文件 - **外部來源有風險**從外部 URL fetch 內容的 Skill 可能被攻陷 - **工具濫用**惡意 Skill 可能以有害方式調用工具 - **視同安裝軟件**只使用可信來源的 Skills。 ## Skills 與其他功能對比 | 功能 | 調用方式 | 最適合 | |------|----------|--------| | **Skills** | 自動或 /name | 可復用專業能力、工作流 | | **Slash 命令** | 用戶發起 /name | 快捷方式已并入 skills | | **子代理Subagents** | 自動委派 | 隔離的任務執行 | | **記憶CLAUDE.md** | 始終加載 | 持久項目上下文 | | **MCP** | 實時 | 外部數據/服務訪問 | | **Hooks** | 事件驅動 | 自動化副作用 | ## 內置 Skills Claude Code 自帶一組開箱即用、無需安裝配置的內置 Skills同樣遵循 SKILL.md 格式 | Skill | 描述 | |-------|------| | /simplify | 審查已變更文件的可復用性、質量與效率并行生成 3 個審查子代理 | | /batch instruction | 使用 git worktrees 在代碼庫中編排大規模并行變更 | | /debug [description] | 通過讀取 debug 日志排查當前會話問題 | | /loop [interval] prompt | 按時間間隔重復運行 prompt如 /loop 5m check the deploy | | /claude-api | 加載 Claude API/SDK 參考文檔在 anthropic/anthropic-ai/sdk import 時自動激活 | ## 分享 Skills ### 項目級 Skills團隊共享 1. 在 .claude/skills/ 中創建 Skill 2. 提交到 git 3. 團隊成員拉取變更——Skills 立即可用。 ### 個人 Skills bash # 復制到個人目錄 cp -r my-skill ~/.claude/skills/ # 讓腳本可執行 chmod x ~/.claude/skills/my-skill/scripts/*.py【免費下載鏈接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.項目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考