文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载导读本文基于 Claude Code 系统提示词中的项目技能维护指令system-prompts/system-prompt-project-skill-upkeep-for-feedback-memory.md解析一条贯穿记忆写入 → 技能更新两个持久化通道的联动规则当用户纠正了 Agent 执行某个可重复步骤验证、提交、开 PR、使用技能的方式Agent 在保存feedback记忆的同时必须把同样的纠正折入驱动该步骤的项目技能。读完本文你将掌握这套机制的完整约束只编辑不创建、避免遮蔽内置技能、verify 唯一例外、单文件就近落盘以及如何在SKILL.md中写出简洁、通用、下次会话无需提示即可用对的纠正条目。一、机制全景为什么纠正不能只写进记忆Claude Code 的持久化体系里feedback记忆是专门存放用户对工作方式的指导的一类记忆。根据 system-prompts/system-prompt-memory-description-of-user-feedback.md 的定义Guidance the user has given you about how to approach work — both what to avoid and what to keep doing. These are a very important type of memory to read and write as they allow you to remain coherent and responsive to the way you should approach work in the project.而记忆的定位是对未来会话有用、而非仅限当前会话的信息参见 system-prompts/system-prompt-memory-persistence-scope.md。这意味着用户每次说不要那样做应该这样提交验证要先跑 lint本质上是希望这个行为约定从今往后一直生效。问题在于仅写入记忆是被动的——记忆需要 Agent 在后续会话中主动检索并想起而技能Skill即.claude/skills/name/SKILL.md中封装的步骤化工作流是主动驱动的——当任务匹配时技能会被自动加载并指导执行流程。把纠正同时折入技能等于把被动提醒升级为主动默认行为让下一个会话无需提示unprompted就能做对。二、核心规则把纠正折入驱动该步骤的项目技能关联文档给出的操作指令非常明确When you save afeedbackmemory because the user corrected how you ran a repeatable step — how you verified, committed, opened a PR, or used a project skill — fold the same correction into the project skill that drives that step (.claude/skills/name/SKILL.md)拆解这条规则的关键要素触发时机保存feedback记忆且原因是用户纠正了可重复步骤的执行方式。关于何种场景会触发这类记忆system-prompts/system-prompt-feedback-memory-save-guidance.md 给出了更完整的判断标准用户纠正你的方法不是那样别这么做停止做 X或确认某个非显而易见的做法有效没错正是这样完美继续这样且该经验对未来会话适用。典型场景枚举文档明确点出了四类高频可重复步骤——验证verify、提交commit、开 PR、使用项目技能。这些都是每次执行方式一致、且用户有明确偏好的流程。目标位置驱动该步骤的项目技能文件即.claude/skills/name/SKILL.md。所谓驱动该步骤的技能是指当前会话实际执行这一步时加载的那份 SKILL.md。编辑风格必须是简洁terse、通用general的编辑。不是把某一次的具体操作细节原样粘贴而是提炼成一条对这类场景普遍适用的约束或偏好这样它在未来所有相似情境下都成立。三、硬性约束只编辑已有技能绝不新建这是整套机制中最容易踩坑的一条规则Edit existing skill files only; never create one — a new project skill silently shadows a same-named built-in skill.为什么不能新建项目级技能.claude/skills/name/SKILL.md与 Claude Code 内置技能built-in skill同名时项目技能会静默遮蔽silently shadow同名内置技能。也就是说你为了让验证步骤更贴合本项目而新建一个verify技能结果可能把官方内置的验证工作流整个替换掉而且没有任何警告提示——这是比纠正没生效更严重的副作用。这一点在仓库的其他系统提示词中也有交叉印证system-prompts/skill-doctor-slash-command.md 中把bundle 内置技能与用户安装的扩展明确区分对待内置技能不应被轻易建议停用侧面说明内置技能在体系中占据特殊位置被同名项目技能遮蔽会显著改变行为system-prompts/skill-init-claude-md-and-skill-setup-new-version.mdPhase 6在引导创建技能时也强调如果偏好对应到已有的内置技能如/verify应写一个在其之上叠加项目特定约束的项目技能并明确告知用户内置技能仍然存在、项目技能是增量additive——同样遵循不破坏内置能力的原则。因此规则总结为遇到被纠正的可重复步骤先检查该项目是否已有对应技能有则编辑无则一般情况不得新建转而把纠正留在 feedback 记忆本身。四、唯一例外verify 技能允许创建规则只有一条例外——verifyThe single exception is verify, because how a project verifies changes is project-specific为什么 verify 特殊验证方式跑哪些测试、先 lint 还是先单测、用哪个命令、检查哪些产物是高度项目相关project-specific的。Claude Code 的内置 verify 流程无法预知每个仓库的验证约定而每个仓库恰恰都需要一个符合自身测试结构的 verify 技能。因此验证类纠正应写入.claude/skills/verify/SKILL.md如果该文件不存在允许创建这是唯一允许新建技能的路径同时要把 verify 纠正写入离它所覆盖代码最近的.claude/skills/verify/SKILL.md全仓库通用的验证纠正→ 仓库根目录.claude/skills/verify/SKILL.md仅适用于某个子树的验证纠正例如只在 iOS 子项目生效的测试约定→ 子项目目录内的.claude/skills/verify/SKILL.md如ios/.claude/skills/verify/SKILL.md。这条就近原则利用了 Claude Code 的技能加载机制当 Agent 在ios/子树内工作时位于该子树下的技能优先于仓库根目录的同名技能被考虑从而让纠正精确作用于其所属的代码范围。五、作用域规则每条纠正只落一个文件绝不重复扩散关联文档收尾给出了最后一条铁律Each correction lives in exactly one skill file: the closest-scoped one, never duplicated at broader scopes.每条纠正只存在于一个技能文件中且是作用域最近的那一个绝不在更广作用域重复。这条规则防止两种错误重复维护如果同一个纠正既写进ios/.claude/skills/verify/SKILL.md又写进根目录的 verify 技能未来更新时会出现两份内容漂移、相互矛盾作用域污染把只对某个子树成立的约定提升到全仓库范围会让其他模块的会话错误套用。决策时遵循最近作用域优先纠正适用于哪里就只写进覆盖该范围的最小技能文件。整条规则链最终形成如下判定流程用户纠正了一个可重复步骤的执行方式 ├─ 保存 feedback 记忆同时进行记忆是基础通道 └─ 该步骤是否由某个项目技能驱动 ├─ 是 → 编辑 .claude/skills/name/SKILL.md简洁、通用 ├─ 否且该步骤是 verify → 写入/创建就近的 .claude/skills/verify/SKILL.md │ └─ 全仓纠正 → 仓库根目录子树纠正 → 子树目录 └─ 否且不是 verify → 不新建技能纠正仅保留在 feedback 记忆 每条纠正只落在作用域最近的一个技能文件中不向更广作用域重复六、如何把纠正写进 SKILL.md结构参考简洁、通用的编辑目标需要落到 SKILL.md 的具体结构上。仓库中 system-prompts/system-prompt-skillify-current-session.md 给出了完整的 SKILL.md 编写规范可作为编辑时的参照Frontmattername、description、when_to_use告诉模型何时自动调用、可选allowed-tools、context、arguments等其中disable-model-invocation: true可用于有副作用的工作流如/deploy让只有用户能触发见 skill-init-claude-md-and-skill-setup-new-version.md Phase 6。Step 结构每个步骤配Success criteria成功标准这能让技能在步骤完成时有把握地继续推进可选标注ExecutionDirect / Task agent / Teammate / [human]、Artifacts后续步骤依赖的数据、Human checkpoint不可逆操作前的暂停点、Rules硬性规则。具体到把纠正折入技能的编辑动作对应关系如下feedback 记忆要素SKILL.md 落点规则本身该怎么做对应步骤的正文描述或Rules标注Why用户为什么这样要求往往来自过往事故或强烈偏好该步骤的Human checkpoint/Rules备注帮助判断边界情况How to apply何时何地生效步骤描述与when_to_use/ 就近作用域的文件位置这个映射与 feedback 记忆自身的正文结构完全同构——system-prompts/system-prompt-feedback-memory-body-structure.md 规定记忆正文应以规则先行然后是Why:行和How to apply:行组织因为知道为什么你才能判断边界情况而不是盲目服从规则。技能中的纠正条目同理只写做什么而不写为什么的条目在未来遇到相似但略有不同的场景时Agent 将无法判断该纠正是否适用。七、记忆与技能的协同谁负责什么把整套机制放回 Claude Code 的持久化体系看feedback 记忆和项目技能各司其职、互为补充feedback 记忆负责通用指导它随会话被检索帮助 Agent 保持对项目工作方式的一致响应system-prompts/system-prompt-memory-description-of-user-feedback.md 特别强调要同时记录失败与成功——只记纠正会让人回避过去的错误却逐渐偏离用户已验证过的好做法甚至变得过度谨慎。项目技能负责流程驱动它是可重复工作流的封装任务匹配时自动加载让纠正后的行为在下一个会话无需提示地生效——这正是关联文档反复强调的 so the next session gets it right unprompted。verify 例外的存在说明凡是因项目而异的行为约定最终归宿都应该是项目技能必要时新建凡是跨项目通用的行为约定留在记忆中即可。八、落地检查清单将本文机制应用于实际项目时可以按以下清单自查用户纠正了验证/提交/开 PR/技能使用等可重复步骤是否同时保存了 feedback 记忆该步骤是否有对应的项目技能文件有 → 编辑保持简洁、通用没有且不是 verify →不新建纠正留在记忆若是 verify 纠正是否写入了离代码最近的.claude/skills/verify/SKILL.md全仓纠正用仓库根目录子树纠正用ios/.claude/skills/verify/SKILL.md这类子目录文件不存在时是否按唯一例外创建了它每条纠正是否只存在于一个技能文件未向更广作用域重复编辑内容是否包含规则、Why、How to apply 三要素让未来会话既能照做、又能判断边界情况最后提醒技能文件的结构健康直接影响这套机制的效果——system-prompts/skill-doctor-slash-command.md 指出frontmatter 解析失败的 SKILL.md 仍会被加载但所有字段都会失效名称回退为目录名、描述回退为正文首行allowed-tools、disable-model-invocation等将静默失效。因此在编辑技能时务必保证 frontmatter 的 YAML 语法正确否则纠正条目同样会落入看似存在、实际不生效的陷阱。赞分享文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载相关推荐Matt Pocock Skills 之 to-spec把一次 Agent 会话沉淀为可跨会话执行的规格文档Matt Pocock Skills 之 to spec把一次 Agent 会话沉淀为可跨会话执行的规格文档 to spec 是 Matt Pocock SkAI 技能AI 插件OMI × Reflect 集成指南把 AI 对话记忆自动沉淀为可检索的每日笔记OMI × Reflect 集成指南把 AI 对话记忆自动沉淀为可检索的每日笔记 本文聚焦于 FriendOMI插件体系中的 Reflect 集成讲解如人工智能AI 应用语音移动开发后端桌面应用智能硬件MCP 服务oh-my-pi 的 learn 工具把一次性调试经验沉淀为长期记忆与可复用技能oh my pi 的 learn 工具把一次性调试经验沉淀为长期记忆与可复用技能 导读 在长会话式 Coding Agent 的日常工作中最难积累的资产不是人工智能AI Agent代码智能体工具调用CLIMCP Clients上一篇5分钟解锁《鸣潮》120FPS帧率WaveTools画质优化与抽卡分析终极指南下一篇EZCard高效智能的桌游卡牌批量生成器解放设计师的创意时间创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考