AI Pulse

给AI写“工作手册”,多步任务自动执行不刷屏

给AI写“工作手册”,多步任务自动执行不刷屏

Claude Code 推出了一套自定义配置体系,核心组件都放在项目根目录的 .claude/ 文件夹下,包括规则、技能、子代理、钩子和输出样式。

规则文件(.claude/rules/)可以限定路径范围。比如规则只针对 src/api/** 下的文件生效,用户处理文档时这条规则不会进入上下文,节省上下文空间。

技能(.claude/skills/)是一个文件夹,包含指令、脚本和资源。每个技能有一个 SKILL.md 文件,包含名称、描述和主体。会话开始时只加载名称和描述,完整内容在 Claude 调用该技能时才加载——以此降低上下文占用。

用户级文件(如用户级 CLAUDE.md)会为每个 Claude Code 会话加载,无论当前仓库是什么。开发者可以把个人偏好(比如提交信息格式)写进这个文件,切换项目后自动生效。

子代理(.claude/agents/)在自己的独立上下文窗口中运行,最终只返回一条总结消息和元数据,不把中间过程塞满主会话。子代理可以嵌套最多五层,动态工作流能协调数十到数百个后台代理,无需开发者指定每个子代理的架构细节。

如果 AI 绝对不可以做某件事,指令不是正确的工具——真正的护栏必须是确定性的,强制执行的方法是钩子和权限。钩子(hooks)是用户定义的命令、HTTP 端点或 LLM 提示,在文件编辑、工具调用、会话开始等事件时触发。由于配置位于主上下文窗口之外,钩子的上下文成本很低。管理设置(managed settings)更进一步:由管理员部署,不能被用户本地配置覆盖,是唯一能强制执行组织级确定性护栏的方式。

输出样式(.claude/output-styles/)注入系统提示,不会被压缩,每次会话开始时加载,因此有最高的指令遵循权重。但需要注意:自定义输出样式默认会移除 Claude 作为软件工程师助手的核心指令(如变更范围、添加注释、安全与验证习惯),除非在文件头部设置 keep-coding-instructions: true。

追加系统提示(append-system-prompt)只追加到原始系统提示,不会修改 Claude 的角色,且只对当前调用生效。它有较高的上下文成本,指令越多遵循度越低,尤其当指令存在矛盾时。

技能、子代理、钩子、输出样式可以打包为插件,在团队或项目间共享。这套自定义体系仅适用于 Claude Code,不是对所有 AI 助手都可用。

阅读原文
📚 相关主题 AI 编码

📬 订阅 AI Pulse

每天三次更新,不错过重要信号

▲ 回到顶部