ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

claude-code-best-practice:用三个 Markdown 文件给 Claude Code 扩展能力

claude-code-best-practice:用三个 Markdown 文件给 Claude Code 扩展能力 claude-code-best-practice用三个 Markdown 文件给 Claude Code 扩展能力【免费下载链接】claude-code-best-practicefrom vibe coding to agentic engineering - practice makes claude perfect项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice很多人想给 Claude Code 加新功能时第一反应是去写代码。但打开 claude-code-best-practice 这个仓库你会注意到它的扩展点几乎全是 Markdown 文件。这个仓库把自己当作 Claude Code 的参考实现——Skills按目录组织、可被斜杠命令调用的能力包、Subagents独立上下文里干活的子代理、Commands自定义斜杠命令在这里各有一套最佳实践加一套可直接抄的落地文件。拿到仓库之后先读哪里git clone https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice把仓库拉到本地后目录结构本身就是导航best-practice/下是各组件的写法规范implementation/下是对应的可用实现reports/里是调研笔记。新手最常见的弯路是只读规范不读实现结果照抄出来的 frontmatter 字段缺斤少两。建议每个主题都两个文件对照着看比如写技能就对照 best-practice/claude-skills.md 和 implementation/claude-skills-implementation.md。Command → Agent → Skill仓库的编排骨架仓库里跑得最完整的例子是天气系统三层职责切得很干净Command是入口负责和用户交互、编排整体流程它本身是纯 Markdown 指令不含可执行代码Agent负责取数启动时预加载一个领域知识技能用 Agent 工具调用而不是 bash 命令Skill独立产出结果通过 Skill 工具被直接调起。[](implementation/assets/impl-agent-teams.png)拿天气示例走一遍最小流程你在终端输入/weather-orchestrator命令先问你要摄氏度还是华氏度然后把任务交给weather-agent——它带着预加载的weather-fetcher技能去拉温度拿到数值后再调起独立的weather-svg-creator技能输出一张 SVG 天气卡片。这里暗藏一个值得记的区分技能有预加载进代理和被工具独立调用两种挂载方式前者适合当领域知识后者适合当独立工序。CLAUDE.md 加载时机单体仓库最容易被问懵的点[](best-practice/assets/claude-memory/claude-memory-monorepo.jpg)新手在大型项目里最容易困惑的是为什么我写的 CLAUDE.md 好像没生效。这个仓库把它讲得很透加载规则就三条祖先文件启动即载从你启动 claude 的目录一路向上走到文件系统根沿途每个 CLAUDE.md 立即进上下文子孙文件懒加载子目录里的 CLAUDE.md 不会在启动时读入只有当 Claude 真正读写那个目录里的文件时才会加载可以把它理解成一种特殊技能兄弟文件永不加载你在frontend/干活backend/CLAUDE.md永远不会进上下文。所以大型仓库的正确组织方式是仓库根目录放全局规范各子模块目录放自己的 CLAUDE.mdClaude 碰到哪个模块就带哪份说明上下文不会被无关内容撑爆。排查记忆没生效时先问一句这份文件对我来说算祖先还是子孙子孙的话没触发加载属于正常现象不是 bug。完整规则在 best-practice/claude-memory.md。把成果推到插件市场功能调通只是开始。这个仓库本身就是一个插件市场的活案例——仓库里演示的 Agent Teams、Goal、定时任务等实现最终都是以可分发的插件包形式交付的。你可以照着同样路径在自己的项目里验证 Command/Agent/Skill 组合把文件整理成插件包发布出去再回社区收反馈迭代。想动手的话直接打开仓库里的 orchestration-workflow/orchestration-workflow.md从天气示例的完整流程图开始照着最小链路跑一遍即可。【免费下载链接】claude-code-best-practicefrom vibe coding to agentic engineering - practice makes claude perfect项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表