SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场claude-code-system-prompts

claude-code-system-prompts

智能体与模型

查看项目

更新于 10-16 10:36

技能介绍

Claude Code System Prompts

本技能提供关于 Claude Code 系统提示词、内置工具描述、子代理提示词与实用提示词的专业知识，帮助 AI 代理理解、引用并协助用户定制 Claude Code 的内部提示架构。

用途

该技能面向需要深入了解 Claude Code 内部提示结构的使用者，例如开发者、提示工程研究者或希望调整 Claude Code 行为的用户。它可用于解释 Claude Code 为何使用某个工具、分析子代理的决策依据、追踪提示词随版本的变化，以及为定制提示词提供参考。

仓库内容

claude-code-system-prompts 仓库包含：

  • Claude Code 使用的全部系统提示词（主代理、子代理、实用工具）
  • 24 个内置工具描述（Write、Bash、Read 等）
  • 子代理提示词（Plan、Explore、Task 等 30 多个）
  • 实用提示词（CLAUDE.md 生成、压缩、安全审查等）
  • 系统提醒（约 40 个条件式提示片段）
  • 每个提示组件的 token 数量
  • 版本历史（CHANGELOG.md），记录 180 多个版本中提示词的变化

据资料显示，该仓库在每次 Claude Code 发布后数分钟内更新（资料称当前为 v2.1.143，2026 年 5 月 15 日）。

安装与访问

克隆仓库：

git clone https://github.com/Piebald-AI/claude-code-system-prompts.git
cd claude-code-system-prompts

提示词以单个 Markdown 文件形式组织在 ./system-prompts/ 目录下：

system-prompts/
├── agent-prompt-explore.md
├── agent-prompt-plan-mode-enhanced.md
├── builtin-tool-write.md
├── main-system-prompt.md
├── system-reminder-*.md
└── ...

关键组件

1. 主系统提示词

核心 Claude Code 代理提示词：

cat system-prompts/main-system-prompt.md

Token 数量： 约 8,500 tokens（随配置变化）

主要内容包括：身份与能力、内置工具使用准则、文件操作最佳实践、错误处理与恢复、代码质量标准。

2. 内置工具

Claude Code 有 24 个内置工具，每个都有详细描述。资料列举的关键工具及其 token 数量：

  • Write - 文件创建/编辑（2,100 tokens）
  • Bash - 命令执行（1,800 tokens）
  • Read - 文件读取（900 tokens）
  • List - 目录列表（600 tokens）
  • Search - 代码库搜索（1,200 tokens）

查看 Write 工具描述：

cat system-prompts/builtin-tool-write.md

3. 子代理提示词

Claude Code 使用专门的子代理，资料列举了以下示例：

Explore Agent（575 tokens）：

cat system-prompts/agent-prompt-explore.md

Plan Agent（715 tokens）：

cat system-prompts/agent-prompt-plan-mode-enhanced.md

其他代理：通用子代理（285 tokens）、安全审查代理（2,521 tokens）、后台任务代理（427 tokens）、记忆合成代理（443 tokens）。

4. 系统提醒

约 40 个根据上下文添加的条件式提示片段：

# 列出所有系统提醒
ls system-prompts/system-reminder-*.md

# 示例：文件操作提醒
cat system-prompts/system-reminder-always-use-write-for-file-changes.md

资料提及的常见提醒包括：文件变更始终使用 Write、避免不必要地读取大文件、编辑不熟悉的代码前先使用 Search、破坏性操作前先确认。

定制系统提示词

使用 tweakcc（推荐方式）

tweakcc 可修改提示词并对 Claude Code 安装进行补丁：

# 安装 tweakcc
npm install -g tweakcc

# 导出当前提示词
tweakcc export

# 编辑提示词
nano tweaks/main-system-prompt.md

# 应用更改
tweakcc apply

资料示例展示了在 tweaks/main-system-prompt.md 中添加自定义文件规则后执行 tweakcc apply 的流程。

直接引用提示词

在帮助用户理解 Claude Code 行为时，可引用具体提示词，例如通过 Node.js 读取 ./system-prompts/builtin-tool-write.md 并解析其内容。

常见使用模式

资料给出了以下常见模式：

  1. 理解工具使用：当用户问“Claude 为什么用了 X 工具”时，读取 builtin-tool-${TOOL_NAME}.md 并检索相关系统提醒。
  2. 分析代理行为：查看相应子代理提示词，并参考其 token 预算（如 Explore 575、Plan 715）。
  3. 比较版本：使用 CHANGELOG.md 追踪提示词演变。
  4. Token 预算分析：每个提示文件在 README 中标注 token 数量，可通过脚本提取统计。

与斜杠命令配合

许多斜杠命令有专门的代理提示词，资料列举：

Security Review（/security-review）：

cat system-prompts/agent-prompt-security-review-slash-command.md
# 2,521 tokens

Batch Operations（/batch）：

cat system-prompts/agent-prompt-batch-slash-command.md
# 1,106 tokens

PR Review（/review-pr）：

cat system-prompts/agent-prompt-review-pr-slash-command.md
# 211 tokens

配置与环境

提示词引用了一些环境变量与配置。资料提及的环境变量：

  • ANTHROPIC_API_KEY - API 认证
  • CLAUDE_CODE_CONFIG_DIR - 配置位置（默认：~/.claude-code）

提示词中引用的配置文件：.claudeignore（文件排除模式）、CLAUDE.md（项目上下文）、.claude/memories/（持久记忆文件）。

故障排查

资料列出以下排查方向：

  • Claude 未遵循自定义规则：检查提示是否已正确应用（tweakcc diff）、确认 token 预算未超限、检查系统提醒是否与修改冲突。
  • 理解意外行为：查找相关代理提示词、检索关键字、查看 CHANGELOG 中最近的修改。
  • Token 预算问题：统计所有活跃提示词的 token 总数。

集成示例

资料给出了若干集成示例，包括自定义提示词校验器（检测与系统提醒的冲突）、提示词文档生成器、提示词 diff 分析器（比较不同版本的提示词变化）。

进阶用法

资料说明这些提示词是从 Claude Code 编译后的源码中提取的，并给出了概念性的提取思路。此外还列出了记忆相关提示词：记忆合成（443 tokens）、Dream 记忆整合（859 tokens）、记忆修剪（456 tokens）。

资源

  • 仓库： https://github.com/Piebald-AI/claude-code-system-prompts
  • tweakcc 工具： https://github.com/Piebald-AI/tweakcc
  • Piebald（替代方案）： https://piebald.ai
  • Changelog： https://github.com/Piebald-AI/claude-code-system-prompts/blob/main/CHANGELOG.md
  • X 更新： https://x.com/PiebaldAI

许可证

MIT - 与源仓库相同。