This repository demonstrates how to use Claude Code to do real engineering work, not just writing code. 本项目是极客时间专栏 《Claude Code 工程化实战》 的官方配套示例仓库,目标就是: 👉 把 Claude Code 从“对话式编码工具”,变成 可设计、可复用、可治理的工程系统。
FAQ
claude-code-engineering is a Claude Code plugin with 12 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes code-reviewing, api-conventions, api-documenting. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
$ npx -y skills add huangjia2019/claude-code-engineering --agent claude-code
Repo: huangjia2019/claude-code-engineering
这本书和极客时间的课程不是同一份内容,而是互补的两条腿。
| 📕 《Claude Code 实战》(书) | 🎯 Claude Code 工程化实战(极客时间课程) | |
|---|---|---|
| 形态 | 10 章纸质书 | 23 讲音频专栏 + 音频(还有一些前沿加餐视频内容) |
| 节奏 | 体系化阅读,章节之间环环相扣 | 一讲一个主题,独立可拆,碎片时间消化 |
| 取舍 | 把整个 Claude Code 的技术全景讲透讲深,重原理与心法 | 在书的基础上加项目、加更新、加深度案例——(很多朋友说课程讨论区是高价值精华!) |
| 代码 | 章节配套代码片段(99-书籍代码/,226 个片段) | 每讲一个 projects/ 子目录,可直接跑 |
| 适合谁 | 想用一本书系统建立 Claude Code 完整心智模型 | 想跟着真实项目一步步做,把每个机制吃透 |
配合阅读:
📕 先读书,建立 10 章的完整骨架(记忆 / Skills / SubAgent / Hooks / MCP / Headless / SDK / Plugins)→ 🎯 再跟课程,每个机制用 2-3 讲深挖项目细节、踩坑现场和最新更新。
一本书一门课,正好把 Claude Code 的"骨"和"肉"补全。
📕 欢迎大家翻翻这本新书 —— 不管是刚接触 Claude Code 想找一本权威入门,还是已经在用想把整套工程化方法论补齐,这本书都能帮你少踩很多坑。
🛒 京东购买链接:https://item.jd.com/15374814.html
Designing AI Agents —— 生产级 AI Agent 设计模式的工程参考。
双轴框架(7 认知功能 × 6 执行拓扑)· 27 个 agent 设计模式 · 4 个真实领域案例。
配套代码:huangjia2019/designing-ai-agents · huangjia2019/agent-design-patterns · 配套论文:arXiv:2605.13850
《Agent 设计模式之美》 —— 沉淀 ADPS 通用范式,做可成长的 Agent 系统。
英文书讲"是什么",中文专栏讲"到底怎么落地" —— 每一讲从源码里抠出一个可复用的 Agent 组件,配最小可运行 Python 代码,直接搬进你的项目。
你会在里面拿到
- 🧭 双轴框架 · 中文首发 —— 认知功能(感知 / 记忆 / 推理 / 行动 / 反思 / 协作 / 治理)× 执行拓扑(链式 / 路由 / 并行 / 循环 / 层级 / 编排)的 33 组件矩阵,一次看清 Agent 系统全景
- 🧩 33 个可复用 Harness 组件 —— 从 Claude Code / Codex / OpenClaw / Hermes 等顶级 Agent 系统源码里提炼,每个配代码 + 反模式 + 何时不该用
- 🛠 完整选型方法论 —— Pattern Selection Card(ASSESS → ROUTE → SELECT)+ 六步选型法(Bound → Map → Select → Pick → Assess → Build),从需求直通落地
适合谁
- 3-5 年工程经验、用过 LLM API、正在想"怎么把 Agent 搞进生产"的资深工程师
- 架构师 / 技术负责人 / CTO —— 需要一套通用范式做团队 Agent 系统选型
- 已经看过入门课想再深一层的进阶读者
不适合:AI 入门用户(先看入门课)· 只想拿"能跑 demo"的同学(demo 网上很多,本课讲的是为什么这么写)
配套代码:huangjia2019/agent-design-patterns · 配套论文:arXiv:2605.13850 · ADPS 白皮书 / 蓝皮书:adpsagent.com
🎯 这是我为极客时间2026年制作的最新专栏,目标:快速掌握 Claude Code 高阶技能,进行工程化的 Agent 实战
Claude Code 不只是一个命令行助手,而是一个可扩展的 AI Agent 框架——理解其技术栈全貌是掌控它的第一步。
让 Claude 记住你的项目规范、编码风格和团队约定,从每次重复说明到一次配置永久生效。
把"一个大脑"拆成多个"专职岗位"——理解隔离执行、权限边界和上下文管理的工程价值。
项目:代码审查员 — 用 Read/Grep/Glob 构建一个只能看、不能改的安全审计角色。
项目:测试运行器 & 日志分析器 — 让子代理去消化 500 行输出,只把结论带回主对话。
项目:多视角探索 & Bug 修复流水线 — 当任务可以并行或分阶段时,子代理如何协作。
项目:Agent 团队 — 从单次委派到多会话持久协作,构建具有角色分工和状态传递的 Agent 团队。
Description 不只是说明文档,而是触发器——掌握让 Claude 自动发现并逐渐加载技能的关键写法。
项目:团队标准命令集 — 用 /review、/deploy、/commit 固化团队最佳实践——它们的本质是设了 disable-model-invocation: true 的 Skill。
项目:财务分析 Skill — 目录页、章节、附录三层结构,把 token 利用率提升 98%。
先理解组合的全貌,再动手构建组件,最后组装成完整的专家。
先看清全景,再掌握利器,最后融会贯通。
一个 Markdown 文件格式,用 125 天从一个产品特性变成行业开放标准。这不是偶然——它揭示了 AI Agent 生态中,什么样的机制能活下来,什么样的知识能跨越边界。
在 Claude 执行工具前后插入自定义检查,阻止危险命令、保护敏感文件、自动格式化代码——在小问题萌芽时就防止它演变成灾难。
从 Stop Hook 质量门控到 SubAgent 事件验收,从 frontmatter 精准配置到三维决策框架——每一步都设防,构建滴水不漏的 Hook 工程体系。
一个开放协议,让 Claude Code 从只能操作本地文件的工具,进化为能连接整个数字世界的智能枢纽——数据库、API、云服务,百川归海,一协议通。
十几个精选的原语工具覆盖五个原子操作,通过涌现产生无限复杂能力——理解工具背后的设计哲学,用起来才能游刃有余。
当 Claude Code 脱离人的实时操控,以守护进程般的姿态嵌入流水线,开发团队获得的不只是效率提升,而是一种全新的人机协作节奏。
指令规则告诉 Claude 该怎么做,权限规则告诉 Claude 能做什么——两套规则协同运作,构成整个系统的行为约束体系。
SDK 把 Claude Code 的能力拆解为可编程的接口——query() 和 ClaudeCodeOptions,让你像调用函数一样驱动 AI Agent。
项目:自动化测试修复 Agent — 自定义工具、Hooks 拦截、权限分层和流式会话,构建生产级 AI Agent。
项目:团队能力包 — 把 Commands、Skills、Agents、Hooks、MCP 配置打包成一个可安装、可升级、可分享的插件,实现团队资产沉淀与共享。
《Claude Code 实战》全书 10 章的代码片段已整理到本仓库的 99-书籍代码/ 目录——每章一个子文件夹,按章节内出现顺序编号,可直接 copy-paste。
projects/ 子目录是课程配套的可运行项目(例如 03-SubAgents/projects/、07-MCP/projects/),与书籍片段互补.claude/
settings.json
.gitignore
01-Introduction/
README.md
02-Memory/
projects/
01-web-app/
CLAUDE.md
02-api-service/
CLAUDE.md
03-bloated-claude-md/
.claude/
rules/
api-design.md
database.md
deployment.md
express.md
git-workflow.md
payments.md
performance.md
react.md
security.md
testing.md
typescript.md
CLAUDE-refactored.md
CLAUDE.md
readme.md
03-SubAgents/
projects/
01-code-reviewer/
.claude/
agents/
code-reviewer.md
README.md
src/
api.js
auth.js
database.js
02-test-runner/
.claude/
agents/
test-runner.md
package.json
README.md
src/
calculator.js
calculator.test.js
03-log-analyzer/
.claude/
agents/
log-analyzer.md
logs/
access.log
app.log
error.log
README.md
04-parallel-explore/
.claude/
agents/
api-explorer.md
auth-explorer.md
db-explorer.md
README.md
src/
api/
index.js
middleware.js
routes.js
auth/
index.js
jwt.js
session.js
database/
index.js
migrations.js
models.js
05-bugfix-pipeline/
.claude/
agents/
bug-analyzer.md
bug-fixer.md
bug-locator.md
bug-verifier.md
package.json
README.md
src/
cart-service.js
order-service.js
user-service.js
utils.js
tests/
services.test.js
06-agent-teams-bug-hunt/
.claude/
settings.json
bug-report.md
buggy-app/
db.js
middleware/
cache.js
session.js
package.json
routes/
auth.js
orders.js
users.js
server.js
findings-template.md
hooks/
task-completed.sh
teammate-idle.sh
investigation-report.md
README.md
team-prompt.md
readme.txt
04-Skills/
projects/
00-basic-skill/
.claude/
skills/
code-reviewing/
SKILL.md
README.md
SKILL.md
src/
auth.js
01-reference-skill/
.claude/
skills/
api-conventions/
SKILL.md
README.md
02-progressive-skill/
.claude/
skills/
api-documenting/
EXAMPLES.md
PATTERNS.md
scripts/
detect_routes.py
validate_openapi.sh
SKILL.md
STANDARDS.md
templates/
endpoint.md
index.md
openapi.yaml
EXAMPLES.md
PATTERNS.md
README.md
scripts/
detect_routes.py
validate_openapi.sh
SKILL.md
STANDARDS.md
templates/
endpoint.md
index.md
openapi.yaml
03-financial-skill/
.claude/
skills/
financial-analyzing/
reference/
costs.md
profitability.md
revenue.md
scripts/
calculate_ratios.py
SKILL.md
templates/
analysis_report.md
data/
analysis_report.md
sample_financials.json
README.md
reference/
costs.md
profitability.md
revenue.md
scripts/
calculate_ratios.py
SKILL.md
templates/
analysis_report.md
04-codebase-visualizer/
.claude/
skills/
codebase-visualizer/
scripts/
visualize.py
SKILL.md
README.md
scripts/
visualize.py
SKILL.md
05-api-generator/
.claude/
skills/
api-generating/
EXAMPLES.md
PATTERNS.md
scripts/
detect_routes.py
validate_openapi.sh
SKILL.md
STANDARDS.md
templates/
endpoint.md
index.md
openapi.yaml
EXAMPLES.md
PATTERNS.md
README.md
scripts/
detect_routes.py
validate_openapi.sh
SKILL.md
STANDARDS.md
templates/
endpoint.md
index.md
openapi.yaml
06-agent-skill-combo/
.claude/
agents/
api-doc-generator.md
skills/
api-generating/
scripts/
detect-routes.py
SKILL.md
templates/
api-doc.md
docs/
api/
orders.md
users.md
README.md
src/
routes/
orders.js
users.js
07-skill-fork-demo/
.claude/
skills/
code-health-check/
SKILL.md
README.md
src/
app.js
routes/
categories.js
products.js
utils/
db.js
08-skill-pipeline/
.claude/
agents/
doc-writer.md
quality-checker.md
route-scanner.md
settings.local.json
skills/
doc-writing/
SKILL.md
templates/
endpoint-doc.md
quality-checking/
rules/
doc-standards.md
SKILL.md
route-scanning/
scripts/
scan-routes.py
SKILL.md
CLAUDE.md
README.md
src/
routes/
categories.js
products.js
README.md
05-Commands/
projects/
01-basic-commands/
.claude/
commands/
commit.md
explain.md
git/
log.md
status.md
review.md
todo.md
README.md
02-advanced-commands/
.claude/
commands/
analyze.md
pr-create.md
safe-deploy.md
README.md
README.md
06-Hooks/
projects/
01-safety-hooks/
.claude/
logs/
audit-2026-03-07.log
settings.json
hooks/
audit-log.sh
block-dangerous.sh
protect-files.sh
README.md
02-quality-hooks/
.claude/
settings.json
hooks/
auto-format.sh
lint-check.sh
run-tests.sh
package.json
README.md
src/
math.js
math.test.js
README.md
07-MCP/
projects/
01-basic-config/
.env.example
.mcp.json
.mcp.json.example
README.md
02-custom-server/
package.json
src/
index.ts
tsconfig.json
README.md
08-Headless/
projects/
01-github-actions/
.github/
workflows/
pr-review.yml
02-scripts/
review.sh
README.md
09-Agent-SDK/
projects/
01-hello-agent/
hello.py
02-code-analyzer/
analyzer.py
03-custom-tools/
tool_demo.py
04-test-fixer/
fixer.py
src/
calculator.py
tests/
test_calculator.py
README.md
10-Plugins/
projects/
01-my-first-plugin/
agents/
quick-fix.md
commands/
explain.md
todo.md
plugin.json
README.md
02-mcp-example/
mcp-servers/
fetch.json
filesystem.json
plugin.json
README.md
03-team-toolkit/
.claude-plugin/
plugin.json
.mcp.json
agents/
quick-fix.md
security-scanner.md
commands/
deploy.md
review.md
test.md
hooks/
auto-format.sh
check-bash.sh
hooks.json
README.md
skills/
... 266 more© 2026 Flowy · Free and open source
Built for Claude Code · Not affiliated with Anthropic