A2 — 建立可重复使用的 CLI 工作流程（CLI Workflow Patterns）¶

繁體中文 | 简体中文 | English

← A1 — CLI 入门 · Track A: CLI Power User 第 2 站

⏱ 时间估算：1-2 周（约 8-15 小时）

📋 本章组成：学习目标 → 进入条件 → 必修阅读 → 动手练习 → 精选 Projects → 自我检查 🔑 关键名词：见 resources/glossary.zh-Hans.md 5（CLAUDE.md / slash command / SKILL.md / plugin / portable prompt）

装好 CLI、跑过第一个任务之后，下一个问题：怎么让 CLI 一致地、可重复地、可分享地做事？这节讲 workflow pattern——把“我每次都要重打一遍 prompt”变成“设好一次后 CLI 自己会用对方法”。

📌 学习目标¶

写一份 production-grade 的 CLAUDE.md / AGENTS.md——production-grade 的最低构成：(1) 角色 + (2) 项目背景 + (3) 禁止事项 + (4) 测试指令 + (5) 交付格式。实务上 30-50 行可同时涵盖这 5 件事；超过 50 行通常该拆文件
设计可重复的 slash command / custom prompt
把多步骤任务拆成 CLI 能跑完的小步骤
设计 prompt 让任务在不同 CLI 上 portable

📚 必修阅读¶

Anthropic — CLAUDE.md best practices ⭐
Stage 2 — Prompt 设计 — workflow design 跟 prompt design 是同一件事的两面
Stage 5.1 — Claude Code 基础 — slash commands 细节
resources/cli-agents-guide.zh-Hans.md “跨 CLI 都通用的 prompt 写法” — portable prompt 原则

🛠 动手练习¶

动手练习 CLI-5：写 production CLAUDE.md¶

你 CLAUDE.md 应该至少包含： - 角色：“你是一个 senior Python engineer / 学术写作为助手 / 等” - 这个 repo 的 context：是什么项目、用什么套件、有什么 convention - 不能做的事：别乱改 main、别动 secrets、别 commit - 怎么做事：先 plan、跑 test 再 commit、要写 type hint - 常用指令：怎么跑 test、怎么 lint、怎么 deploy

把这份提交到 git。下次新成员 clone repo，他的 Claude Code 自动加载你的 convention。

动手练习 CLI-6：第一个 slash command¶

写 .claude/commands/review.md（或对应 CLI 的位置）：

---
name: review
description: Review staged changes for security + style
---

请执行以下流程：
1. `git diff --cached` 抓 staged 的 changes
2. 找：hard-coded secrets、SQL injection、type errors
3. 对应 CLAUDE.md 内的 style 规则检查
4. 输出：PASS / 或 list of 具体要改的点

之后每次 /review，CLI 都跑同一套流程。

动手练习 CLI-7：多步骤任务拆解¶

给 CLI 一个复杂任务（譬如“把这 50 个 markdown 翻译成英文 + 加 frontmatter + 移到 en/ 子目录”）。 - 第一次：直接丢整个任务 → 观察 CLI 怎么做、什么地方会错 - 第二次：你先拆成 5 个 sub-task，逐一给 CLI → 观察结果差别 - 学到：CLI 跟你一样，太大的任务要拆；给太小的任务又会 over-orchestrate

⭐ 进阶补充：Claude Code 原生 multi-agent 机制（这 1 句先看就好，不展开）：CLI-7 教的“手动拆 sub-task”其实 Claude Code 有 Subagent / Agent team / Background agent 三种原生工具可以自动化。完整 3 种机制 + 动手练习 + 何时不该用（团队权限、上下文隔离、结果审查流程都要先想好）见 Stage 5.5——在 A2 阶段先知道有这层，不需要学细节。

动手练习 CLI-8：Portable prompt¶

写一个 prompt 给 Claude Code 跑成功了。换到 Codex / OpenCode / Gemini CLI 跑同一个 prompt——什么地方需要改？通常会发现： - file path convention 不同（cwd vs absolute） - 对“执行 shell”的权限默认不同 - “先 plan 再做”的 prompt 在某些 CLI 要明确说，在某些是默认行为

把这些差异整理成你自己的 cheat sheet。

🎯 精选 Projects¶

CLAUDE.md 范例库¶

Anthropic 官方文档 ¶

official — Claude Code memory / CLAUDE.md 编写的官方说明，含 best practices。

obra/superpowers ⭐⭐⭐⭐¶

★ 178k+ — 不只是 skill collection，也是 production CLAUDE.md 范本。看 .claude/ whole directory structure。

mattpocock/skills ⭐⭐⭐⭐¶

工程师日常用的 skill 库。.claude/ structure 是好参考。更多 skill 范例见 Stage 5.3 — Skills。

Slash Commands / Custom Prompts¶

anthropics/claude-plugins-official ⭐ 官方¶

★ 18k+ — 官方 plugin marketplace。每个 plugin 内的 commands / skills 是 slash command 范例。

hesreallyhim/awesome-claude-code ¶

社群整理的 Claude Code 资源清单。逛里面的 slash command 范例。

Prompt 设计参考¶

f/awesome-chatgpt-prompts ⭐⭐⭐⭐¶

★ 161k+ — 虽然是 ChatGPT 起家，prompt 写法 90% 在 CLI 上也通。

Stage 2 — Prompt Engineering 全部 entry¶

完整列表 — DSPy、Prompt-Engineering-Guide 等。

多 CLI 并用 pattern¶

`resources/cli-agents-guide.zh-Hans.md` “3 个常见搭配”¶

看 Setup A / B / C，挑一个合的试。

✅ 进 A3 前的自我检查¶

你能不能： - [ ] 写过至少 1 份你 production / 工作 repo 的 CLAUDE.md（不是 demo repo） - [ ] 写过至少 2 个 slash command 并实际在用 - [ ] 把同一个 prompt 在 2 个不同 CLI 上跑过、知道差异 - [ ] 讲得出“什么任务该拆、什么任务不该拆”的判准

如果可以 → 进 A3 — Integration & Production。

如果不行 → CLAUDE.md 一直 demo 等于白写；先去你真实 repo 写一份再回来。

💡 常见坑¶

CLAUDE.md 写太长：超过 100 行 CLI 会自己 truncate / 忽略后段。Sweet spot 30-60 行。
Slash command 写成“请做 X、Y、Z、A、B”一句：CLI 容易跳步骤。改写成编号 list + 每步成功标准。
Portable 过头：每个 CLI 还是有自己的特长；不要为了能跨 CLI 把 prompt 变得太抽象、失去具体性。
觉得自己“都会”就不写了：CLAUDE.md 是给未来的你（跟新成员）看的，不是给现在的你看的。