claude-code-prompts 是一个独立编写的 AI 编程 Agent Prompt 模板合集，涵盖系统提示词、工具指令、子 Agent 委派、记忆管理和多 Agent 协调五大方向。本文带你快速看懂仓库里9 大类别模板各自解决什么问题，并给出一份新手上手清单，让你少走弯路 🧭

仓库结构一览：一张表看懂全部分类

下面逐类拆解。

1️⃣ System Prompt：给 Agent 定身份和底线

系统提示词是整个 Agent 的"行为宪法"：它定义身份、权限模型、任务执行纪律、代码风格、风险意识和沟通风格，要求每条指令都可执行、可测试，而不是空泛建议。

• 完整模板：system-prompt.md
• 架构解析：01-system-prompt-architecture.md

解决什么问题：Agent 行为不稳定、越权操作、输出啰嗦、改动代码前先乱写——这份模板用"分层规则"（身份 > 硬约束 > 工作流 > 输出格式）一次性把这些钉死。

2️⃣ Tool Prompts：11 个工具指令覆盖日常操作

每个工具一份独立指令模板，覆盖文件、Shell、搜索和网络交互，存放在 complete-prompts/tool-prompts/：

解决什么问题：Agent 用错工具、shell 里乱跑危险命令、编辑不精确导致文件被改坏——每个工具一份专属约束，路由和边界一目了然。配套解析见 04-tool-specific-instructions.md。

3️⃣ Agent Prompts：5 个专职子 Agent 各司其职

子 Agent 模板存放在 complete-prompts/agent-prompts/，每个针对一类任务：

• 通用型general-purpose.md：调研、搜索、多步骤任务
• 代码探索code-explorer.md：只读模式导航代码库
• 方案架构师solution-architect.md：设计与规划
• 验证专家verification-specialist.md：对抗式测试，给出 PASS/FAIL/PARTIAL 结论
• 文档向导documentation-guide.md：文档编写任务

解决什么问题：一个"全能 Agent"干所有事容易失焦。按任务类型拆分专职子 Agent，职责清晰、结果更可控。委派时机与方法见 05-agent-delegation.md。

4️⃣ Memory Prompts：长会话不丢上下文

记忆模板存放在 complete-prompts/memory-prompts/，共 4 份：

• conversation-summary.md：9 段式上下文压缩（禁用工具，纯文本输出）
• session-notes.md：结构化跟踪会话状态
• memory-extraction.md：从近期消息中提炼持久记忆
• memory-consolidation.md：定期清理与合并记忆

解决什么问题：长对话上下文溢出、跨会话"失忆"、重复确认已知信息。这套模板让 Agent 能压缩、沉淀和整理记忆。原理见 07-memory-and-context.md。

5️⃣ Coordinator Prompt：多 Agent 协作的"总指挥"

coordinator-prompt.md 定义了一个编排者角色：它派 Worker 调研、把结果综合成方案、指挥实施并安排验证，四个阶段（Research → Synthesis → Implementation → Verification）流程完整。

解决什么问题：多 Agent 各自为战、结果无法汇总、互相重复劳动。协调者模板明确了"什么该派、什么自己做"，还规定了 Worker 结果的返回格式。深入解析见 08-multi-agent-coordination.md。

6️⃣ Utility Prompts：提升体验的四个小助手

存放在 complete-prompts/utility-prompts/，短小但实用：

• session-title.md：自动生成 3~7 词的会话标题
• tool-summary.md：30 字符内的工具动作摘要
• away-recap.md："你离开期间发生了什么"回顾
• next-action-suggestion.md：推荐下一步操作

解决什么问题：UI 层面的细节——会话不好认、动作不可见、回来后没上下文。这类"辅助提示词"是产品化 Agent 体验的关键，解析见 09-auxiliary-prompts.md。

7️⃣ Pattern Analyses：9 篇模式解析教你方法

patterns/ 目录下每篇文档 = 模式说明 + 为什么有效 + 可复用模板，是仓库里最好的"教程"：

1. 01-system-prompt-architecture.md — 系统提示词分层架构
2. 02-core-behavioral-rules.md — 反过度工程、最小改动
3. 03-safety-and-risk-assessment.md — 可逆性分级、危险操作门禁
4. 04-tool-specific-instructions.md — 按工具路由与约束
5. 05-agent-delegation.md — 何时/如何派生子 Agent
6. 06-verification-and-testing.md — 对抗式验证、防止"自我合理化"
7. 07-memory-and-context.md — 摘要、笔记、记忆提取
8. 08-multi-agent-coordination.md — 协调者模式与结果综合
9. 09-auxiliary-prompts.md — 标题、回顾、建议类小助手

解决什么问题：只抄模板不懂原理，换场景就不会写。先读解析再抄模板，才是可持续的做法 💡

8️⃣ Cursor Skills：拖进 Cursor 直接用的技能

skills/ 目录提供 3 个即插即用技能，实现方式见 skills/README.md：

• coding-agent-standards/SKILL.md — 编码 Agent 行为基线
• verification-agent/SKILL.md — 对抗式验证工作流（含 strategies.md）
• prompt-architect/SKILL.md — Prompt 设计方法论（含 reference.md）

解决什么问题：模板"看懂了但用不上"。Cursor 用户把skills/复制到~/.cursor/skills-cursor/即可立即集成，零配置见效 ✅

9️⃣ 项目文档与许可：安全使用的前提

• DISCLAIMER.md：独立创作声明，项目与 Anthropic 无关，"Claude Code"为名义性合理使用
• LICENSE：MIT 许可，原始内容可免费商用
• CHANGELOG.md：版本历史

解决什么问题：版权边界不清楚不敢用——读一遍免责声明就放心了。

新手快速上手：4 步清单

1. 读模式：先看 patterns/ 里任意一篇，理解生产级 Agent 如何组织提示词
2. 抄模板：从 complete-prompts/system-prompt.md 等完整模板里挑一个拷入自己的 Agent 配置
3. 填占位符：把{{PLACEHOLDER}}替换成你的技术栈、工具名和风险策略
4. 装技能：Cursor 用户直接把skills/放进~/.cursor/skills-cursor/

总结

claude-code-prompts 的价值在于把"好用的编码 Agent 长什么样"拆成了9 类可直接取用的 Prompt 模板 + 9 篇原理解析：系统提示词管行为底线，工具提示词管操作边界，Agent 提示词管任务分工，记忆提示词管上下文，协调者提示词管多 Agent 协作，辅助提示词管体验细节。按上面的清单顺序读一遍 patterns、挑几份模板填好占位符，你就能快速搭出一个行为稳定的编程 Agent 🚀