如何编写有效的 CLAUDE.md 文件
本文介绍了如何编写高效的 CLAUDE.md 文件,基于 Anthropic 工程团队的最佳实践。文章强调了保持文件简洁、内容通用的重要性,并提供了具体的结构和编写技巧,如使用强调标记和分层组织内容。
本文介绍了如何编写高效的 CLAUDE.md 文件,基于 Anthropic 工程团队的最佳实践。文章强调了保持文件简洁、内容通用的重要性,并提供了具体的结构和编写技巧,如使用强调标记和分层组织内容。
面向编程小白 Claude Code 入门教程。作者结合 Opus 5.5 更新后的日常使用经验,从 Chat 与 Code 的区别讲起,介绍桌面 App 的下载安装、界面布局、权限模式(Manual/Accept edits/Plan/Auto)的选择,并通过文件整理案例演示第一个任务的完整流程。随后讲解改动撤回与安全保险机制、项目文件夹的组织方法,重点解析 CLAUDE.md(规矩)、项目文档(进度)、资料与记忆四个易混淆概念,给出 CLAUDE.md 的写作原则与两份可直接套用的模板,并分享了开发 Obsidian 插件、制作宣传视频等实战案例。
文章提出'研究工程'(Research Engineering)的实践方法,指出常见AI搜索工具只是'带浏览器的流畅回答',其核心缺陷在于缺少支撑证据的系统。作者提出一个与模型无关的六阶段研究工作流架构:定义研究简报、拆解查询计划、搜索与抓取、记录证据账本、验证声明冲突、生成带来源报告。文章强调要给agent明确的研究契约(含范围、时间点、比较维度、停止条件),将问题拆成目的不同的并行搜索通道,而非让多个agent读同样的资料制造虚假共识。还介绍了多源检索策略(开放网络、X、私人文档库、数据库/API),核心目标是让AI返回更少的不受支持的声明,并持续追踪'它如何知道自己所说的是真的'。
本文系统讲解如何像招聘员工一样引入和管理 Grok Bot 等 AI Agent。作者指出常见错误是创建机器人后立刻连接所有工具并交给模糊任务。正确做法包括:定义岗位而非任务,用一句话职责加五个字段(职责、输入、可自主执行、需请示、完成标准)写成岗位说明书;首个任务应选择高频且可逆的简单工作;正式执行前先让机器人以文本形式说明计划;完成标准必须可检验而非模糊的质量词汇;权限遵循最小化原则,以可逆性划界。整体框架包括试用、考察期、基于证据的晋升和每周复盘。
文章介绍了 AI PM OS——一套面向产品经理的 Agent Skill 体系。作者强调:与其信任模型凭提示词自由发挥,不如为 Agent 配备结构化技能,确保输出质量稳定。核心方法论是'监督比你更聪明的人':通过间接提示让 Agent 自己复述问题、避免被先入为主的假设带偏,并用 /first-principles、/mckinsey-issue-tree、/causal-tree、/jtbd-forces 等技能栈按'定义问题、选择赌注、理解用户、定义成功、塑造构建、写作、推动组织'分阶段组织工作。同时利用记忆和历史会话,让 Agent 继承过往决策背景,提升产品判断力。
文章系统讲解了 Claude Opus 5.5 的提示词工程方法。作者指出 Opus 5.5 是首个官方提示指南以“删减”为主的前沿模型:模型会自主决定思考深度,手动思考预算已失效,强制工具调用不再支持。核心心智模型是把 Claude 当作毫无上下文的天才新同事,需明确目标、提供充分背景、给出示例、用 XML 标签结构化输入、指定输出格式。新模型的关键变化是 effort(低/中/高/超高/最大)成为控制智能、延迟与成本的首要杠杆,默认为 medium;应停止使用“仔细思考”“一步步推理”等旧式提示,而用 effort 控制思考量。文中还包含 API 调用示例与新旧提示写法的对比。
本文深入探讨了 Claude 模型中 effort(努力程度)参数的作用与使用策略。作者通过实验和 Terminal Bench 3.0 基准测试分析发现:effort 本质上是控制模型在任务上投入的算力与自主判断程度。高 effort 在验证和边界测试重要的场景(如硬件、代码审查、安全)表现更佳;低/中 effort 则适合快速迭代、保持人类在环。作者还比较了不同规格化程度任务在各级 effort 下的输出差异,并总结出一套高效工作流:先让模型访谈自己补全规格,用低 effort 实现,人工审查后,再用高 effort 做验证和测试。