from vibe coding to agentic engineering - practice makes claude perfect

= Agent · = Command · = Skill

Boris Cherny on X (tweet 1 · tweet 2 · tweet 3)

功能	位置	描述
Subagent	.claude/agents/<name>.md	全新隔离上下文中的自主执行者 — 自定义工具、权限、Model、Memory 和持久化身份
Command	.claude/commands/<name>.md	注入到现有 Context 中的知识 — 简单的用户调用 Prompt 模板，用于工作流编排
Skill	.claude/skills/<name>/SKILL.md	注入到现有 Context 中的知识 — 可配置、可预加载、可自动发现，支持 Context Fork 和渐进式披露 · 官方 Skill
Workflow	.claude/commands/weather-orchestrator.md
Hook	.claude/hooks/	用户定义的处理程序（脚本、HTTP、Prompt、Agent），在特定事件上运行在 Agentic Loop 之外 · 指南
MCP Server	.claude/settings.json、.mcp.json	Model Context Protocol 连接，连接外部工具、数据库和 API
Plugin	可分发包	Skill、Subagent、Hook、MCP Server 和 LSP Server 的捆绑包 · 市场 · 创建市场
Settings	.claude/settings.json	分层配置系统 · 权限 · Model 配置 · 输出样式 · 沙箱 · 快捷键 · 快速模式
Status Line	.claude/settings.json	可自定义的状态栏，显示 Context 使用量、Model、成本和会话信息
Memory	CLAUDE.md、.claude/rules/、~/.claude/rules/、~/.claude/projects/<project>/memory/	通过 CLAUDE.md 文件和 @path 导入实现持久化 Context · 自动 Memory · 规则
Checkpointing	自动（基于 git）	自动跟踪文件编辑，支持回滚（Esc Esc 或 /rewind）和目标性总结
CLI 启动参数	claude [flags]	启动 Claude Code 的命令行参数、子命令和环境变量 · 交互模式 · 环境变量
AI 术语		Agentic Engineering · Context Engineering · Vibe Coding
最佳实践		官方最佳实践 · Prompt 工程 · 扩展 Claude Code

功能	位置	描述
Power-ups	/powerup	互动课程，通过动画演示教授 Claude Code 功能（v2.1.90）
Ultraplan	/ultraplan	在云端起草计划，支持基于浏览器的审查、内联评论和灵活执行 — 可远程执行或传送回终端
Claude Code Web	claude.ai/code	在云基础设施上运行任务 — 长时间运行的任务、PR 自动修复、并行会话，无需本地设置 · 定时任务
Agent SDK	npm / pip 包	使用 Claude Code 作为库构建生产级 AI Agent — Python 和 TypeScript SDK，内置工具、Hook、Subagent 和 MCP · 快速入门 · 示例
No Flicker Mode	CLAUDE_CODE_NO_FLICKER=1	无闪烁的替代屏幕渲染，支持鼠标、稳定的 Memory 和应用内滚动 — 可选的预览研究
Computer Use	computer-use MCP server	让 Claude 控制你的屏幕 — 在 macOS 上打开应用、点击、输入和截图 · 桌面
Auto Mode	claude --enable-auto-mode	后台安全分类器替代手动权限提示 — Claude 决定什么是安全的，同时阻止 Prompt 注入和风险升级 · 使用 claude --enable-auto-mode（或 --permission-mode auto）启动，或在会话中用 Shift+Tab 切换至此 · 博客
Channel	--channels，基于插件	将 Telegram、Discord 或 Webhook 的事件推送到运行中的会话 — 你不在时 Claude 也能响应 · 参考
Slack	Slack 中的 @Claude	在团队聊天中 @Claude 并附带编码任务 — 路由到 Claude Code Web 会话进行 Bug 修复、代码审查和并行任务执行
Code Review	GitHub App（托管）	多 Agent PR 分析，在合并前捕获 Bug、安全漏洞和回归 · 博客
GitHub Actions	.github/workflows/	在 CI/CD 流水线中自动执行 PR 审查、Issue 分类和代码生成 · GitLab CI/CD
Chrome	--chrome，扩展	通过 Chrome 中的 Claude 实现浏览器自动化 — 测试 Web 应用、调试控制台、自动化表单、从页面提取数据
定时任务	/loop、/schedule、cron 工具	/loop 在本地按周期运行 Prompt（最多 3 天）· /schedule 在 Anthropic 基础设施的云端按周期运行 Prompt — 即使你的机器关机也能工作 · 公告
语音听写	/voice	按住说话的语音输入支持 Prompt，支持 20 种语言，可重新绑定激活键
Simplify & Batch	/simplify、/batch	用于代码质量和批量操作的内置 Skill — 简化重构以实现复用和效率，批量运行跨文件命令
Agent Team	内置（环境变量）	多个 Agent 在同一代码库上并行工作，共享任务协调
Remote Control	/remote-control、/rc	从任何设备继续本地会话 — 手机、平板或浏览器 · 无头模式
Git Worktree	内置	用于并行开发的隔离 git 分支 — 每个 Agent 获得自己的工作副本
Ralph Wiggum Loop	插件	用于长时间运行任务的自主开发循环 — 迭代直到完成

详见 编排工作流，了解 Command → Agent → Skill 模式的实现细节。

claude
/weather-orchestrator

所有主要工作流都遵循相同的架构模式：研究 → 计划 → 执行 → 审查 → 交付

名称	★	独特性	计划
Everything Claude Code	148k		planner	47	82	182
Superpowers	143k		writing-plans	5	3	14
Spec Kit	87k		speckit.plan	0	9+	0
gstack	68k		autoplan	0	0	37
Get Shit Done	50k		gsd-planner	24	68	0
BMAD-METHOD	44k		bmad-create-prd	0	0	39
OpenSpec	39k		opsx:propose	0	11	0
oh-my-claudecode	27k		ralplan	19	0	37
Compound Engineering	14k		ce-plan	51	4	43
HumanLayer	10k		create_plan	6	27	0

• 跨 Model 工作流（Claude Code + Codex）
• RPI
• Ralph Wiggum Loop
• Andrej Karpathy（OpenAI 创始成员）工作流
• Peter Steinberger（OpenClaw 创始人）工作流
• Boris Cherny（Claude Code 创始人）工作流 — 13 个技巧 · 10 个技巧 · 12 个技巧 · 2 个技巧 · 15 个技巧

🚫👶 = 不要盯着看

Prompting · 规划 · CLAUDE.md · Agent · Command · Skill · Hook · 工作流 · 高级 · Git / PR · 调试 · 工具 · 日常

■ Prompting (3)

技巧	来源
给 Claude 挑战 — "审查这些变更，在我通过你的测试之前不要创建 PR" 或者 "向我证明这能工作"，让 Claude 比较 main 和你的分支 🚫👶
在一个一般的修复之后 — "基于你现在知道的一切，废弃这个并实现优雅的解决方案" 🚫👶
Claude 大部分 Bug 能自己修复 — 粘贴 Bug，说 "fix"，不要微观管理怎么做 🚫👶

■ 规划/规格 (6)

技巧	来源
始终从 Plan 模式 开始
从最小规格或 Prompt 开始，让 Claude 使用 AskUserQuestion 工具采访你，然后开一个新会话来执行规格
始终制定阶段性门控计划，每个阶段有多个测试（单元、自动化、集成）
启动第二个 Claude 作为 Staff Engineer 审查你的计划，或使用 跨 Model 进行审查
编写详细规格并在交接前减少歧义 — 你越具体，输出越好
原型 > PRD — 构建 20-30 个版本而不是写规格，构建成本很低所以多尝试

■ CLAUDE.md (7)

技巧	来源
CLAUDE.md 应该控制在 200 行以内 每文件。Humanlayer 中 60 行（仍然不是 100% 保证）
用 <important if="..."> 标签 包裹特定领域的 CLAUDE.md 规则，防止文件变长时被 Claude 忽略
monorepo 使用 多个 CLAUDE.md — 祖先 + 后代加载
使用 .claude/rules/ 拆分大型指令
memory.md、constitution.md 不能保证任何事情
任何开发者都应该能够启动 Claude，说 "run the tests" 然后第一次就能工作 — 如果不能，你的 CLAUDE.md 缺少必要的 setup/build/test 命令
保持代码库干净并完成迁移 — 部分迁移的框架会让 Model 困惑，可能选择错误的模式
使用 settings.json 强制执行 harness 行为（归属、权限、Model）— 当 attribution.commit: "" 是确定性的时，不要在 CLAUDE.md 中写 "NEVER add Co-Authored-By"

Agent (4)

技巧	来源
使用特定功能的 Subagent（额外 Context）和 Skill（渐进式披露）而不是通用的 QA、Backend Engineer
说 "use subagents" 以在问题上投入更多计算 — 分担任务保持主 Context 干净和专注 🚫👶
使用 Agent Team 和 tmux 以及 git worktree 进行并行开发
使用 测试时计算 — 分离的 Context 窗口让结果更好；一个 Agent 可能引入 Bug，另一个（相同 Model）可以发现它们

Command (3)

技巧	来源
使用 Command 实现工作流而不是 Subagent
为你每天多次做的每个"内部循环"工作流使用 Slash Command — 节省重复的 Prompt，Command 放在 .claude/commands/ 中并提交到 git
如果你做某事超过一次，就把它变成 Skill 或 Command — 构建 /techdebt、context-dump 或分析 Command

Skill (9)

技巧	来源
使用 context: fork 在隔离的 Subagent 中运行 Skill — 主 Context 只看到最终结果，而不是中间的工具调用。agent 字段让你设置 Subagent 类型
monorepo 使用 子文件夹中的 Skill
Skill 是文件夹而不是文件 — 使用 references/、scripts/、examples/ 子目录实现 渐进式披露
在每个 Skill 中构建 Gotchas 部分 — 最高信号内容，随着时间添加 Claude 的失败点
Skill description 字段是触发器而不是总结 — 为 Model 编写（"我什么时候应该触发？"）
不要在 Skill 中陈述显而易见的事情 — 专注于推动 Claude 走出默认行为的内容 🚫👶
不要在 Skill 中束缚 Claude — 给出目标和约束，而不是规定性的分步说明 🚫👶
在 Skill 中包含脚本和库，让 Claude 组合而不是重构 boilerplate
在 SKILL.md 中嵌入 !`command` 以将动态 shell 输出注入 Prompt — Claude 在调用时运行它，Model 只看到结果

■ Hook (5)

技巧	来源
在 Skill 中使用 按需 Hook — /careful 阻止破坏性命令，/freeze 阻止目录外的编辑
使用 PreToolUse Hook 测量 Skill 使用 以发现受欢迎或触发不足的 Skill
使用 PostToolUse Hook 自动格式化代码 — Claude 生成格式良好的代码，Hook 处理最后 10% 以避免 CI 失败
通过 Hook 将 权限请求 路由到 Opus — 让它扫描攻击并自动批准安全的请求 🚫👶
使用 Stop Hook 在轮次结束时推动 Claude 继续或验证其工作

■ 工作流 (7)

技巧	来源
避免 Agent 傻瓜区，在 50% 最大时手动 /compact。如果切换到新任务，使用 /clear 重置 Context 中途
普通的 cc 比任何工作流对小任务都更好
使用 /model 选择 Model 和推理，/context 查看 Context 使用量，/usage 检查计划限制，/extra-usage 配置超额计费，/config 配置设置 — 使用 Opus 做计划模式，Sonnet 做代码，两全其美
在 /config 中始终使用 思考模式 true（查看推理）和 输出样式 Explanatory（查看带有 ★ Insight 框的详细输出），以便更好地理解 Claude 的决策
在 Prompt 中使用 ultrathink 关键字实现 高努力推理
/rename 重要会话（例如 [TODO - 重构任务]）稍后 /resume 它们 — 同时运行多个 Claude 时标记每个实例
当 Claude 偏离轨道时使用 Esc Esc 或 /rewind 撤销，而不是在同一 Context 中尝试修复它

■ 高级工作流 (6)

技巧	来源
大量使用 ASCII 图表来理解你的架构
使用 /loop 进行本地循环监控（最多 3 天）· 使用 /schedule 进行云端循环任务，即使你的机器关机也能运行
使用 Ralph Wiggum 插件 进行长时间运行的自主任务
/permissions 使用通配符语法（Bash(npm run *), Edit(/docs/**)）而不是危险地跳过权限
/sandbox 通过文件和网络隔离减少权限提示 — 内部减少 84%
投资 产品验证 Skill（signup-flow-driver、checkout-verifier）— 值得花一周时间完善

■ Git / PR (5)

技巧	来源
保持 PR 小而专注 — p50 为 118 行（141 个 PR，一天 45K 行变更），每个 PR 一个功能，易于审查和回滚
始终 压缩合并 PR — 干净的线性历史，每个功能一个提交，易于 git revert 和 git bisect
经常提交 — 尝试每小时至少提交一次，任务完成后立即提交
在同事的 PR 上标记 @claude 以自动生成 lint 规则来处理重复的审查反馈 — 将自己从代码审查中自动化出来 🚫👶
使用 /code-review 进行多 Agent PR 分析 — 在合并前捕获 Bug、安全漏洞和回归

■ 调试 (7)

技巧	来源
养成习惯，在遇到任何问题时截图并与 Claude 分享
使用 MCP（Chrome 中的 Claude、Playwright、Chrome DevTools）让 Claude 自己查看 Chrome 控制台日志
始终要求 Claude 将你想要的终端（你想查看日志的）作为后台任务运行，以便更好地调试
/doctor 诊断安装、认证和配置问题
压缩期间的错误可以通过使用 /model 选择 1M token Model 然后运行 /compact 来解决
使用 跨 Model 进行 QA — 例如 Codex 用于计划和实现审查
Agent 搜索（glob + grep）优于 RAG — Claude Code 尝试并放弃了向量数据库，因为代码会漂移不同步且权限复杂

■ 工具 (5)

技巧	来源
使用 iTerm/Ghostty/tmux 终端而不是 IDE（VS Code/Cursor）
/voice 或 Wispr Flow 用于语音 Prompt（10 倍生产力）
claude-code-hooks 用于 Claude 反馈
状态栏 用于 Context 感知和快速压缩
探索 settings.json 功能，如 Plans Directory、Spinner Verbs 以获得个性化体验

■ 日常 (2)

技巧	来源
每天 更新 Claude Code
每天开始时阅读 变更日志

视频 / 播客	来源	YouTube
我们在 Research-Plan-Implement 中犯的所有错误 (Dex) | 2026/03/24 | MLOps Community		YouTube
使用 Boris Cherny 构建 Claude Code (Boris) | 2026/03/04 | The Pragmatic Engineer		YouTube
Claude Code 负责人：编码解决后会发生什么 (Boris) | 2026/02/19 | Lenny's Podcast		YouTube
与其创始人 Boris Cherny 深入 Claude Code (Boris) | 2026/02/17 | Y Combinator		YouTube
Boris Cherny（Claude Code 创始人）关于什么让他职业生涯成长 (Boris) | 2025/12/15 | Ryan Peterman		YouTube
构建 Claude Code 的工程师透露的 Secret (Cat) | 2025/10/29 | Every		YouTube

来源	名称	徽章
	r/ClaudeAI、r/ClaudeCode、r/Anthropic
	Claude、Anthropic、Boris、Thariq、Cat、Lydia、Noah、Anthony、Alex、Kenneth
	Jesse Kriss（Superpowers）、Affaan Mustafa（ECC）、Garry Tan（gstack）、Dex Horthy（HumanLayer）、Kieran Klaassen（Compound Eng）、Tabish Gilani（OpenSpec）、Brian McAdams（BMAD）、Lex Christopherson（GSD）、Dani Avila（CC 模板）、Dan Shipper（Every）、Andrej Karpathy（AutoResearch）、Peter Steinberger（OpenClaw）、Sigrid Jin（claw-code）、Yeachan Heo（oh-my-claudecode）
	Anthropic
	Lenny's Podcast、Y Combinator、The Pragmatic Engineer、Ryan Peterman、Every、MLOps Community

如果你有答案，请通过 shanraisshan@gmail.com 告诉我

Memory 和指令 (4)

1. 你应该在 CLAUDE.md 中放什么 — 什么应该省略？
2. 如果你已经有 CLAUDE.md，是否需要单独的 constitution.md 或 rules.md？
3. 你应该多久更新一次 CLAUDE.md，你怎么知道它何时变得过时？
4. 为什么 Claude 仍然忽略 CLAUDE.md 指令 — 即使它们用大写字母写着 MUST？（reddit）

Agent、Skill 和工作流 (6)

1. 你何时应该使用 Command vs Agent vs Skill — 什么时候普通的 Claude Code 更好？
2. 随着 Model 的改进，你应该多久更新一次 Agent、Command 和工作流？
3. 给你的 Subagent 一个详细的角色会提高质量吗？"完美的研究/QA Subagent 角色/Prompt" 是什么样的？
4. 你应该依赖 Claude Code 内置的 Plan 模式 — 还是构建你自己的规划 Command/Agent 来强制执行团队工作流？
5. 如果你有个人 Skill（例如 /implement 带有你的编码风格），你如何整合社区 Skill（例如 /simplify）而不会冲突 — 当它们不同意时谁获胜？
6. 我们到了吗？我们能否将现有代码库转换为规格，删除代码，然后让 AI 仅从那些规格重新生成完全相同的代码？

规格和文档 (3)

1. 你的 repo 中的每个功能都应该有一个 markdown 规格文件吗？
2. 你需要多久更新一次规格，以便在新功能实现时它们不会变得过时？
3. 在实现新功能时，你如何处理对其他功能规格的连锁影响？

1. 像课程一样阅读这个 repo，学习什么是 Command、Agent、Skill 和 Hook，然后再尝试使用它们。
2. 克隆这个 repo 并玩示例，尝试 /weather-orchestrator，听 Hook 声音，运行 Agent Team，这样你可以看到事情实际上是如何工作的。
3. 去你自己的项目，让 Claude 建议你应该从这个 repo 添加哪些最佳实践，给它这个 repo 作为参考，这样它知道什么是可能的。

✨2026 年 3 月在 GitHub 上 trending ✨

claude-code-hooks · codex-cli-best-practice · codex-cli-hooks

#	工作流	描述
1	/workflows:development-workflows	通过并行研究所有 10 个工作流 repo 来更新 DEVELOPMENT WORKFLOWS 表和跨工作流分析报告
2	/workflows:best-practice:workflow-concepts	使用最新的 Claude Code 功能更新 README 核心概念部分
3	/workflows:best-practice:workflow-claude-settings	跟踪 Claude Code 设置报告变更并找出需要更新的内容
4	/workflows:best-practice:workflow-claude-subagents	跟踪 Claude Code Subagent 报告变更并找出需要更新的内容
5	/workflows:best-practice:workflow-claude-commands	跟踪 Claude Code Command 报告变更并找出需要更新的内容
6	/workflows:best-practice:workflow-claude-skills	跟踪 Claude Code Skill 报告变更并找出需要更新的内容