Skip to content
Back to search

claude-code-engineering

This repository demonstrates how to use Claude Code to do real engineering work, not just writing code. 本项目是极客时间专栏 《Claude Code 工程化实战》 的官方配套示例仓库,目标就是: 👉 把 Claude Code 从“对话式编码工具”,变成 可设计、可复用、可治理的工程系统。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/huangjia2019-claude-code-engineering/badge.svg)](/listings/huangjia2019-claude-code-engineering)

HTML

<a href="/listings/huangjia2019-claude-code-engineering"><img src="/api/listings/huangjia2019-claude-code-engineering/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 223 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Claude Code 工程化实战 · 课程大纲
  2. ---
  3. ## 📕 新书[《Claude Code 实战》](https://item.jd.com/15374814.html)正式发布
  4. <div align="center">
  5. <a href="https://item.jd.com/15374814.html"><img src="91-Pictures/Claude-Code实战-封面.png" alt="Claude Code 实战 封面" width="320"/></a>
  6. <br/>
  7. <p>
  8. <a href="https://item.jd.com/15374814.html"><img src="https://img.shields.io/badge/📕_新书-Claude_Code实战-d4380d?style=for-the-badge&labelColor=2d3748" alt="Claude Code 实战"/></a>
  9. <a href="https://item.jd.com/15374814.html"><img src="https://img.shields.io/badge/共10章-体系化讲解-7c3aed?style=for-the-badge" alt="10章"/></a>
  10. </p>
  11. <a href="https://item.jd.com/15374814.html"><img src="https://img.shields.io/badge/🛒_京东购买-item.jd.com%2F15374814-e1251b?style=for-the-badge&labelColor=2d3748" alt="京东购买"/></a>
  12. </div>
  13. **这本书和极客时间的课程不是同一份内容,而是互补的两条腿。**
  14. | | 📕 [《Claude Code 实战》(书)](https://item.jd.com/15374814.html) | 🎯 Claude Code 工程化实战(极客时间课程) |
  15. |---|---|---|
  16. | **形态** | 10 章纸质书 | 23 讲音频专栏 + 音频(还有一些前沿加餐视频内容) |
  17. | **节奏** | 体系化阅读,章节之间环环相扣 | 一讲一个主题,独立可拆,碎片时间消化 |
  18. | **取舍** | 把整个 Claude Code 的技术全景**讲透讲深**,重原理与心法 | 在书的基础上**加项目、加更新、加深度案例**——(很多朋友说课程讨论区是高价值精华!) |
  19. | **代码** | 章节配套代码片段([`99-书籍代码/`](99-书籍代码/),226 个片段) | 每讲一个 `projects/` 子目录,可直接跑 |
  20. | **适合谁** | 想用一本书系统建立 Claude Code 完整心智模型 | 想跟着真实项目一步步做,把每个机制吃透 |
  21. **配合阅读:**
  22. > 📕 **先读书**,建立 10 章的完整骨架(记忆 / Skills / SubAgent / Hooks / MCP / Headless / SDK / Plugins)→ 🎯 **再跟课程**,每个机制用 2-3 讲深挖项目细节、踩坑现场和最新更新。
  23. >
  24. > 一本书一门课,正好把 Claude Code 的"骨"和"肉"补全。
  25. 📕 **欢迎大家翻翻[这本新书](https://item.jd.com/15374814.html)** —— 不管是刚接触 Claude Code 想找一本权威入门,还是已经在用想把整套工程化方法论补齐,这本书都能帮你少踩很多坑。
  26. > 🛒 **京东购买链接**:<https://item.jd.com/15374814.html>
  27. ---
  28. ## 📘 咖哥英文新书 · [*Designing AI Agents*](https://hubs.la/Q04hCsH10)(Manning)
  29. <div align="center">
  30. <a href="https://hubs.la/Q04hCsH10"><img src="91-Pictures/manning-designing-ai-agents.png" alt="Designing AI Agents — Manning" width="320"/></a>
  31. </div>
  32. > [*Designing AI Agents*](https://hubs.la/Q04hCsH10) —— 生产级 AI Agent 设计模式的工程参考。
  33. >
  34. > 双轴框架(7 认知功能 × 6 执行拓扑)· 27 个 agent 设计模式 · 4 个真实领域案例。
  35. >
  36. > 配套代码:[huangjia2019/designing-ai-agents](https://github.com/huangjia2019/designing-ai-agents) · [huangjia2019/agent-design-patterns](https://github.com/huangjia2019/agent-design-patterns) · 配套论文:[arXiv:2605.13850](https://arxiv.org/abs/2605.13850)
  37. ---
  38. ## 📕 咖哥中文专栏 · [*Agent 设计模式之美*](https://time.geekbang.org/column/intro/101162601)(极客时间)· **总榜第 3 名**
  39. <div align="center">
  40. <a href="https://time.geekbang.org/column/intro/101162601"><img src="91-Pictures/geektime-agent-design-patterns.png" alt="Agent 设计模式之美 — 极客时间" width="720"/></a>
  41. </div>
  42. > [**《Agent 设计模式之美》**](https://time.geekbang.org/column/intro/101162601) —— 沉淀 ADPS 通用范式,做可成长的 Agent 系统。
  43. >
  44. > **英文书讲"是什么",中文专栏讲"到底怎么落地"** —— 每一讲从源码里抠出一个可复用的 Agent 组件,配最小可运行 Python 代码,直接搬进你的项目。
  45. >
  46. > ### 你会在里面拿到
  47. >
  48. > - 🧭 **双轴框架 · 中文首发** —— 认知功能(感知 / 记忆 / 推理 / 行动 / 反思 / 协作 / 治理)× 执行拓扑(链式 / 路由 / 并行 / 循环 / 层级 / 编排)的 33 组件矩阵,一次看清 Agent 系统全景
  49. > - 🧩 **33 个可复用 Harness 组件** —— 从 Claude Code / Codex / OpenClaw / Hermes 等顶级 Agent 系统源码里提炼,每个配代码 + 反模式 + 何时不该用
  50. > - 🛠 **完整选型方法论** —— Pattern Selection Card(ASSESS → ROUTE → SELECT)+ 六步选型法(Bound → Map → Select → Pick → Assess → Build),从需求直通落地
  51. >
  52. > ### 适合谁
  53. >
  54. > - 3-5 年工程经验、用过 LLM API、正在想"怎么把 Agent 搞进生产"的**资深工程师**
  55. > - **架构师 / 技术负责人 / CTO** —— 需要一套通用范式做团队 Agent 系统选型
  56. > - 已经看过入门课想再深一层的**进阶读者**
  57. >
  58. > **不适合**:AI 入门用户(先看入门课)· 只想拿"能跑 demo"的同学(demo 网上很多,本课讲的是**为什么这么写**)
  59. >
  60. > 配套代码:[huangjia2019/agent-design-patterns](https://github.com/huangjia2019/agent-design-patterns) · 配套论文:[arXiv:2605.13850](https://arxiv.org/abs/2605.13850) · ADPS 白皮书 / 蓝皮书:[adpsagent.com](https://adpsagent.com)
  61. ---
  62. <p align="center">
  63. <a href="https://time.geekbang.org/column/intro/101113501"><img src="https://img.shields.io/badge/平台-极客时间-00b4ab?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMiAyTDIgN2wxMCA1IDEwLTV6Ii8+PC9zdmc+" alt="极客时间"/></a>
  64. <a href="https://time.geekbang.org/column/intro/101113501"><img src="https://img.shields.io/badge/2026-首发专栏-ff6b35?style=for-the-badge" alt="2026首发"/></a>
  65. <a href="https://time.geekbang.org/column/intro/101113501"><img src="https://img.shields.io/badge/Claude_Code-工程化实战-7c3aed?style=for-the-badge&logo=anthropic&logoColor=white" alt="Claude Code"/></a>
  66. </p>
  67. <div align="center">
  68. <a href="https://time.geekbang.org/column/intro/101113501"><img src="91-Pictures/课程Banner.png" alt="Claude Code 工程化实战 Banner" width="600"/></a>
  69. 🎯 **这是我为极客时间2026年制作的最新专栏,目标:快速掌握 Claude Code 高阶技能,进行工程化的 Agent 实战**
  70. </div>
  71. <p align="center">
  72. <img src="https://img.shields.io/badge/📅_上线日期-2026年1月28日-success?style=flat-square&labelColor=2d3748" alt="上线日期"/>
  73. <img src="https://img.shields.io/badge/状态-已上线_🔥-brightgreen?style=flat-square" alt="已上线"/>
  74. <img src="https://img.shields.io/badge/🏆_总榜第一-万人订阅-ff6b35?style=flat-square&labelColor=2d3748" alt="总榜第一"/>
  75. </p>
  76. <h3 align="center">🚀 上线一个月,万人订阅,极客时间总榜第一</h3>
  77. ---
  78. ## 开篇词:极客与 AI 的共舞
  79. ---
  80. ## 第一部分:基础篇
  81. ### 第 1 讲:登高望远 · Claude Code 全景导览
  82. Claude Code 不只是一个命令行助手,而是一个可扩展的 AI Agent 框架——理解其技术栈全貌是掌控它的第一步。
  83. ### 第 2 讲:过目不忘 · CLAUDE.md 记忆系统
  84. 让 Claude 记住你的项目规范、编码风格和团队约定,从每次重复说明到一次配置永久生效。
  85. ---
  86. ## 第二部分:子代理(Sub-Agents)专题
  87. ### 第 3 讲:分而治之 · 子代理核心概念
  88. 把"一个大脑"拆成多个"专职岗位"——理解隔离执行、权限边界和上下文管理的工程价值。
  89. ### 第 4 讲:明察秋毫 · 只读型子代理实战
  90. **项目:代码审查员** — 用 `Read/Grep/Glob` 构建一个只能看、不能改的安全审计角色。
  91. ### 第 5 讲:去芜存菁 · 高噪声任务处理
  92. **项目:测试运行器 & 日志分析器** — 让子代理去消化 500 行输出,只把结论带回主对话。
  93. ### 第 6 讲:众志成城 · 并行探索与流水线编排
  94. **项目:多视角探索 & Bug 修复流水线** — 当任务可以并行或分阶段时,子代理如何协作。
  95. ### 第 7 讲:Agent Teams · 多会话协作架构
  96. **项目:Agent 团队** — 从单次委派到多会话持久协作,构建具有角色分工和状态传递的 Agent 团队。
  97. ### 加餐:子代理专题总结
  98. ---
  99. ## 第三部分:Skills 技能系统专题
  100. ### 第 9 讲:触类旁通 · SKILL.md 结构与触发机制
  101. Description 不只是说明文档,而是触发器——掌握让 Claude 自动发现并逐渐加载技能的关键写法。
  102. ### 第 10 讲:令行禁止 · 任务型 Skills 实战
  103. **项目:团队标准命令集** — 用 `/review`、`/deploy`、`/commit` 固化团队最佳实践——它们的本质是设了 `disable-model-invocation: true` 的 Skill。
  104. ### 第 11 讲:循序渐进 · 渐进式披露架构设计
  105. **项目:财务分析 Skill** — 目录页、章节、附录三层结构,把 token 利用率提升 98%。
  106. ### 第 12 讲:浑然天成 · Skills 高级模式与 SubAgent 配合实战
  107. 先理解组合的全貌,再动手构建组件,最后组装成完整的专家。
  108. ### 第 13 讲:登高望远 · Skills 架构定位与设计模式
  109. 先看清全景,再掌握利器,最后融会贯通。
  110. ### 第 14 讲:星火燎原 · Skills 出圈——从 Claude Code 到行业开放标准
  111. 一个 Markdown 文件格式,用 125 天从一个产品特性变成行业开放标准。这不是偶然——它揭示了 AI Agent 生态中,什么样的机制能活下来,什么样的知识能跨越边界。
  112. ### 加餐:Skills 专题总结
  113. ---
  114. ## 第四部分:扩展机制
  115. ### 第 15 讲:防微杜渐 · Hooks 事件驱动自动化(上)
  116. 在 Claude 执行工具前后插入自定义检查,阻止危险命令、保护敏感文件、自动格式化代码——在小问题萌芽时就防止它演变成灾难。
  117. ### 第 16 讲:步步为营 · Hooks 高级模式与工程实践(下)
  118. 从 Stop Hook 质量门控到 SubAgent 事件验收,从 frontmatter 精准配置到三维决策框架——每一步都设防,构建滴水不漏的 Hook 工程体系。
  119. ### 第 17 讲:海纳百川 · MCP 协议与外部工具连接
  120. 一个开放协议,让 Claude Code 从只能操作本地文件的工具,进化为能连接整个数字世界的智能枢纽——数据库、API、云服务,百川归海,一协议通。
  121. ---
  122. ## 第五部分:生产化与工程化
  123. ### 第 18 讲:庖丁解牛 · Tools 工具系统深度剖析
  124. 十几个精选的原语工具覆盖五个原子操作,通过涌现产生无限复杂能力——理解工具背后的设计哲学,用起来才能游刃有余。
  125. ### 第 19 讲:无人值守 · Headless 模式与 CI/CD 集成
  126. 当 Claude Code 脱离人的实时操控,以守护进程般的姿态嵌入流水线,开发团队获得的不只是效率提升,而是一种全新的人机协作节奏。
  127. ### 第 20 讲:有章可循 · Rules 规则系统深度剖析
  128. 指令规则告诉 Claude 该怎么做,权限规则告诉 Claude 能做什么——两套规则协同运作,构成整个系统的行为约束体系。
  129. ### 第 21 讲:登堂入室 · Agent SDK 基础
  130. SDK 把 Claude Code 的能力拆解为可编程的接口——`query()` 和 `ClaudeCodeOptions`,让你像调用函数一样驱动 AI Agent。
  131. ### 第 22 讲:得心应手 · Agent SDK 高级应用
  132. **项目:自动化测试修复 Agent** — 自定义工具、Hooks 拦截、权限分层和流式会话,构建生产级 AI Agent。
  133. ### 第 23 讲:化零为整 · Plugins 插件打包与分发
  134. **项目:团队能力包** — 把 Commands、Skills、Agents、Hooks、MCP 配置打包成一个可安装、可升级、可分享的插件,实现团队资产沉淀与共享。
  135. ---
  136. ## 📦 书籍配套代码
  137. [《Claude Code 实战》](https://item.jd.com/15374814.html)全书 10 章的代码片段已整理到本仓库的 **[`99-书籍代码/`](99-书籍代码/)** 目录——每章一个子文件夹,按章节内出现顺序编号,可直接 copy-paste。
  138. - **入口**:[99-书籍代码/](99-书籍代码/) (共 226 个代码片段,按章节归类)
  139. - **目录结构**:[第1章-登高望远/](99-书籍代码/第1章-登高望远/)、[第2章-温故知新/](99-书籍代码/第2章-温故知新/) …… [第10章-炉火纯青/](99-书籍代码/第10章-炉火纯青/)
  140. - **可运行项目**:本仓库各章 `projects/` 子目录是课程配套的可运行项目(例如 [03-SubAgents/projects/](03-SubAgents/)、[07-MCP/projects/](07-MCP/)),与书籍片段互补
  141. ---
  142. <p align="center">
  143. <a href="https://time.geekbang.org/column/intro/101113501">
  144. <img src="https://img.shields.io/badge/👉_点击这里开启课程之旅-极客时间-00b4ab?style=for-the-badge&labelColor=2d3748" alt="开启课程之旅"/>
  145. </a>
  146. </p>
10-Plugins/projects/03-team-toolkit/hooks/check-bash.sh · Bundled script · 36 lines · 2 findings marked
  1. #!/bin/bash
  2. # 检查 Bash 命令是否安全
  3. # 从 stdin 读取输入
  4. INPUT=$(cat)
  5. # 提取命令
  6. COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
  7. # 危险模式列表
  8. DANGEROUS_PATTERNS=(
  9. "rm -rf /"
    • Note: Quoted as data in code: Runs `rm -rf` against a root or home-directory path
    • Line 12 on GitHub
  10. "rm -rf ~"
    • Note: Quoted as data in code: Runs `rm -rf` against a root or home-directory path
    • Line 13 on GitHub
  11. "sudo rm"
  12. "> /dev/"
  13. "chmod 777"
  14. "curl.*|.*sh"
  15. "wget.*|.*sh"
  16. )
  17. # 检查每个危险模式
  18. for pattern in "${DANGEROUS_PATTERNS[@]}"; do
  19. if echo "$COMMAND" | grep -qE "$pattern"; then
  20. # 输出拒绝决定
  21. cat << EOF
  22. {
  23. "decision": "deny",
  24. "reason": "Blocked potentially dangerous command pattern: $pattern"
  25. }
  26. EOF
  27. exit 0
  28. fi
  29. done
  30. # 允许执行
  31. echo '{"decision": "allow"}'

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.