claude-code-prompts
Claude Code 行为规范提示词库,通过系统级指令、工具调用、代理委派模板让 AI 编程助手更
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
Claude Code 行为规范提示词库,通过系统级指令、工具调用、代理委派模板让 AI 编程助手更
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
图1:RepoWise 项目 Logo
想象这样一个场景:你在 VS Code 里接入了 Claude,期望它能像一位经验丰富的工程师那样工作——读懂代码、谨慎修改、出了错能自我诊断。但它却频繁越界,擅自执行危险的 shell 命令;对大型代码库一无所知,连模块间的依赖关系都搞不清楚;上下文一长就开始失忆,前面讨论的内容完全抛到脑后。
这类问题困扰着几乎所有 AI 编程工具的用户。本质上,AI 编程助手是一把极度依赖提示词的瑞士军刀——它的能力边界,很大程度上由你给它的指令决定。但编写高质量提示词本身是一门需要反复试错的技艺,大多数开发者没有时间精力去系统研究。
Claude Code Prompts 正是为解决这一痛点而生。这是一个由独立开发者团队(repowise-dev)维护的开源项目,通过深入研究 Claude Code 的行为模式,逆向工程出一套完整的提示词模板,覆盖了系统级指令、工具调用、代理委派、记忆管理和多智能体协调六大维度。所有提示词均为独立编写,不依赖 Claude 官方的任何内部信息,且明确声明与 Anthropic 无附属关系。
repowise-dev 是一个专注于 AI 代码智能领域的开发者团队,在 GitHub 上维护多个相关项目。其核心产品除了 claude-code-prompts 之外,还有一个叫 RepoWise 的代码库理解引擎,可以自动生成架构文档、依赖图、所有权映射、死代码检测等功能。claude-code-prompts 相当于是 RepoWise 团队把在构建 AI 编程工具过程中积累的提示词工程经验提炼成了一套可独立复用的模板库。
项目采用 MIT 许可证,默认分支为 master,目前已积累 1091 个 GitHub Stars,在 AI 编程工具类提示词仓库中属于头部水平。仓库 topics 覆盖 claude-code、ai-coding-agent、prompt-engineering、multi-agent 等 15 个标签,反映出其专注于 AI 编程代理的精准定位。
仓库按功能分为两大块内容:complete-prompts/ 存放可直接投入使用的完整提示词;patterns/ 目录则包含分章节的设计模式说明,解释每个提示词背后的设计理念,便于二次定制。
1. System Prompt(系统级指令) — 单个最核心的文件,11267 个字符的详细指令集,从 Agent 身份定义、权限模型、系统元数据钩子、任务执行纪律、代码风格约束、风险评估机制到输出格式规范,形成了完整的行为契约。以风险评估为例,提示词将操作分为低/中/高三个风险等级,每个等级对应不同的验证深度和确认要求,确保 AI 在执行高危操作前必须获得用户明确授权。
2. Tool Prompts(工具级调用)× 11 — 覆盖 11 种工具的专项提示词:shell 执行、文件读取、文件编辑、文件写入、grep 搜索、glob 文件匹配、Web 搜索、Web 内容抓取、任务管理、Plan 模式、询问用户。每种工具的提示词都定义了调用规范、输出格式、错误处理和权限边界。以 shell-execution.md 为例,提示词会约束 AI 在执行可能破坏性命令时的行为——必须先呈现将要执行的命令、等待确认后才能执行,而非自动执行。
3. Agent Prompts(代理专项提示词)× 5 — 通用代理、代码探索代理、解决方案架构师代理、验证专家代理、文档指南代理。这些提示词定义了专业角色的职责边界、工作流程和输出规范。例如代码探索代理专注于理解代码库结构和模块关系,不越界做实现;验证专家代理则专注于测试用例设计和回归风险评估。
4. Memory Prompts(记忆管理)× 4 — 对话摘要、会话笔记、记忆提取、记忆整合。这套记忆管理机制解决了长对话中 AI 失忆的常见痛点。通过结构化的会话摘要模板,AI 可以在上下文即将溢出时将关键信息压缩沉淀;通过记忆整合提示词,可以让后续会话继承之前的工作上下文,实现跨会话的连续性。
5. Coordinator Prompt(多智能体协调) — 4739 字符的多智能体编排提示词,定义了研究阶段(并行 workers 收集信息)、综合阶段(主代理独立思考制定计划)、执行阶段(workers 实施计划)的三段式工作流。其中关键原则是研究并行、综合归一——综合阶段必须由主代理独立完成,不能把原始信息直接丢给另一个 worker 去看着办。
6. Utility Prompts(实用工具提示词)× 4 — 远离会话回顾、下一步建议、会话标题、工具总结,提供会话收尾和导航类的小工具提示词。
patterns 目录包含 9 个 Markdown 文件,系统性地讲解了提示词设计的方法论,从系统提示词架构设计、安全与风险评估、Agent 委派策略,到验证测试流程、记忆管理、多智能体协调,覆盖了完整的提示词工程生命周期。这些文档不是简单的模板注释,而是对每个模式为什么这样设计的深度解释,非常适合作为提示词工程的培训材料。
skills 目录借鉴了 Hermes Agent 的技能文档格式(每个技能包含 SKILL.md 作为主入口),收录了 coding-agent-standards(代码代理实施标准)、verification-agent(验证代理策略)、prompt-architect(提示词架构师)三个专项技能文档。这种模块化设计使得提示词可以在不同 Agent 系统间迁移复用。
分层授权模型:系统提示词设定了不可协商的约束层(系统指令 > 开发者指令 > 用户指令 > 工具反馈),在这个框架下,具体的任务指令可以灵活变化而不会破坏 Agent 的基本行为准则。这是当前 AI 编程工具中最被低估的设计原则——大多数提示词只关注做什么,忽略了谁来决定怎么做 的优先级问题。
风险感知型执行:不同于大多数 AI 助手的先执行再道歉模式,本项目的提示词要求 Agent 在行动前先做风险分级。低风险操作(本地文件修改、可逆变更)可直接执行;中等风险需要扩大测试范围并列出回滚路径;高风险必须获得显式用户授权后才能继续。这一机制有效防止了 AI 在处理生产环境代码时的冲动行为。
上下文压缩与记忆分离:将当前会话上下文和长期记忆分离设计,通过结构化的摘要提示词在上下文窗口耗尽前将关键信息迁移到记忆存储,而非简单地截断。这比直接依赖模型的上下文窗口容量更加可控。
多智能体分工协议:Coordinator 提示词定义了 Agent 间的通信规范——使用 Agent/SendMessage/TaskStop 三个协调工具,每个 worker 的结果通过 XML 标签封装传递给主代理。这种结构化格式比纯自然语言的委派方式更加可靠,减少了主代理误解 worker 输出内容的概率。
由于本质是 Markdown 文本库,不存在传统意义上的部署。使用方式有三种层次:
直接引用(入门级):将提示词文本复制粘贴到 Claude、Cline、Cursor 等 AI 编程工具的系统提示词配置中。system-prompt.md 是最核心的起点,直接粘贴到 Claude Code 即可获得一套经过设计的行为约束框架。
集成到现有系统(进阶级):通过 API 方式将提示词注入 Agent 运行时。大多数 Agent 框架(如 LangChain Agent、AutoGPT、CrewAI)都支持在初始化时传入 system prompt,此时可以从 complete-prompts/ 目录中挑选所需的提示词模块组合使用。
二次开发定制(专业级):参考 patterns/ 目录的设计模式说明,理解每个提示词模块的设计意图后,根据自身业务场景进行定制修改。例如将风险评估阈值调整为符合企业内部安全策略,或为特定技术栈(React、Go、Rust)添加专门的代码风格规则。
整体使用门槛极低——只要会用文本编辑器,就可以使用这些提示词;有一定的 Agent 框架使用经验后,可以做深度定制。唯一的门槛是对 AI 编程工具本身有一定使用经验,能理解提示词中描述的场景。
1. 模型依赖性:提示词的效果高度依赖于底层模型的能力边界——本项目的设计大量参考了 Claude 的行为模式(如权限模型、上下文压缩机制),直接迁移到 GPT-4 或其他模型可能效果打折。提示词中的很多设计决策是对 Claude 特定能力(如 Tool Use API)量身定制的。
2. 维护成本:AI 模型更新可能导致行为模式变化,维护者需要持续跟踪 Anthropic 的版本更新并相应调整提示词。项目虽然有 CHANGELOG,但目前版本迭代的节奏和响应速度未知。
3. 不包含实际代码库理解能力:claude-code-prompts 解决的是 Agent 行为规范的问题,但它本身不提供代码库的语义理解能力(如函数调用图、模块依赖关系)。repowise-dev 的另一个项目 RepoWise 正是为解决这个问题设计的,两者配合使用才能发挥最大价值,但 RepoWise 本身也是一个需要单独部署和配置的系统。
claude-code-prompts 代表着提示词工程从玄学调参向工程化积累演进的趋势。随着 AI 编程工具从极客玩具走向工程团队,开发者对如何让 AI 可靠地执行编程任务的需求急剧增长。类似本项目的开源提示词库(如 Aider Polyglot Prompts、Cursor Rules)正在形成一个新的生态位——不依赖特定模型厂商、不绑定特定 IDE,提供社区驱动的最佳实践积累。
从 GitHub Stars 增长曲线来看,AI 编程代理类项目的关注度在 2024-2025 年间呈陡峭上升趋势,而提示词模板库作为元工具,其复用价值和影响力会随着 Agent 生态的扩大而持续增长。本项目在 Claude Code 生态中处于上游基础设施地位,即使终端用户不用 RepoWise,这些提示词工程的设计理念也值得所有 AI 开发者参考借鉴。
# 克隆仓库
git clone https://github.com/repowise-dev/claude-code-prompts.git
cd claude-code-prompts
# 查看完整提示词列表
ls complete-prompts/
# 核心文件:一键启用 Claude Code 行为规范
cat complete-prompts/system-prompt.md
# 多智能体协调示例
cat complete-prompts/coordinator-prompt.md
# 设计模式参考
ls patterns/
推荐从 complete-prompts/system-prompt.md 开始体验,这是整个仓库的基石;如需深度定制,依次阅读 patterns/ 目录的 9 个设计模式文档,理解每个决策背后的逻辑后再动手。