Additional resources
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），仅供参考