- 博客(2408)
- 收藏
- 关注
原创 《Claude Code 从入门到精通》番外1:Skills 是什么?为什么它比 CLAUDE.md 更强大
你让 Claude 生成文档,它需要知道你的文档格式、术语表、模板。你的工作流被拆成了好几块——指令在 CLAUDE.md 里,脚本在 scripts/ 目录下,模板在某个不知道哪里的 .md 文件里。你的 CLAUDE.md 从最初的200行长到了600行——代码规范、错误处理、数据库约定、测试要求、安全红线、禁止事项……这三类任务需要的"专家知识"完全不同,但 CLAUDE.md 是一锅端——不管你做什么,所有知识全部加载。:CLAUDE.md 是"全量加载",Skills 是"按需加载"。
2026-05-27 19:53:36
553
原创 《Agent 工程师养成手册 · 第一季》小册介绍
因为这相当于一本 400 页的实践手册,包含代码、配置和完整的思考框架。比买一个月的 Claude Pro 便宜,但获得的是 6 个月的经验总结。你付的 50 块不是买"固定的课程",而是买"我接下来 12 周的完整经验总结"。所以这个小册: ✓ 不是"永久不变的教程" ✓ 而是"在实践中不断演进的笔记"因为我知道开付费内容的人很多,但真正能帮到你的很少。如果你坚信"最好的学习方式是跟着有经验的人做", 这个小册就是为你写的。只有我在实践中真的踩过的坑、真的优化过的方案,我才会拿出来讲。
2026-05-24 13:15:05
500
原创 第1期:AI Agent 的核心架构,其实就是一个文件夹
几天后,它悄悄改掉了我明确写入的规则,Agent 开始往预期外的方向漂移。后来发现"取数据"用普通代码、"理解+决策"才用 AI,成本降 80% 以上。看文章 → 里面提到"工具调用、记忆系统、编排层、多 Agent 协作" → 脑子里建起一套复杂的技术印象 → 不知道从哪下手 → 放弃。早期我的 Agent 里,取数据用 AI、格式化用 AI、过滤白名单也用 AI。稳了之后再加下一个——比如把周报里的"公众号选题建议"做成独立的 Agent,自动起标题、写大纲。没有版本控制,被改坏的文件就真的没了。
2026-05-24 13:15:05
586
原创 为什么传统产品经理正在被重新定义?
过去,一个产品经理最熟悉的工作节奏大概是这样:业务方提需求,产品经理拆流程、画页面、写字段、定交互,研发排期开发,测试按用例验收,最后上线看数据。你会发现,产品经理面对的不再只是一个页面,而是一个“会判断、会生成、会出错、会消耗成本”的智能系统。你不再只是定义一个功能,而是在定义一个由数据、模型、用户、业务目标、成本和风险共同组成的系统。比如在原来的系统里加一个“AI 生成”按钮、一个“智能推荐”入口、一个“问问 AI”悬浮窗。以前写 PRD,产品经理最常写的是页面、字段、按钮、状态、异常、权限。
2026-05-23 22:54:08
461
原创 《Claude Code 从入门到精通》完结篇:实战案例三,老项目系统性重构
更难的是——**重构没有"完成标志"**。代码变好了,但业务逻辑没变,怎么证明值得?技术经理在会上说:**"我们需要系统性重构一下这个项目。给你们两周时间,但不能影响业务,线上不能出问题。你的团队维护一个电商后台系统,项目已经2年了。前5步花1-2天,后面的改代码才能高效。学完之后:面对任何混乱的老项目,你都有一套系统性的重构方法论。适合人群:已完成前18课,准备挑战最复杂场景的开发者。难度:★★★★★(合集最难的一课)两周重构两年的烂代码,从哪下手?重构的本质:先想清楚"为什么"老项目的系统性重构。
2026-05-17 10:59:39
337
原创 第18课:实战案例二,线上紧急 Bug 修复全过程
阅读时长:约30分钟 · 难度:★★★★☆ 适合人群:已掌握 Claude Code 全部能力,想学会在压力下高效救火的开发者 学完之后:下次遇到线上事故,你能冷静地按流程处理,而不是慌乱乱撞。大部分人在这种场景下会慌——乱查日志、乱改代码、乱发版——最后花了3小时搞定本来1小时能解决的问题。尤其不要跳过阶段1(直接冲去找问题)——你可能花1小时修了个根本不是症状原因的地方。你也争取到了15分钟的安静时间。新功能开发是"计划内"的工作——你有时间思考、设计、测试。技术群里一堆 "收到""收到""收到"
2026-05-09 22:57:41
683
原创 第17课:Claude Code实战案例一,从零开发一个完整 API 模块
我会带你走完整个流程:从接到产品需求,到方案设计,到编码实现,到测试上线,到复盘。学完之后:你会看到一个完整功能从需求到上线的全流程,每一步用了什么 Claude Code 能力。适合人群:学完前16课,想看前面所有知识点怎么串在一个真实项目里的开发者。假设你在一个中型技术团队里,项目是一个技术内容平台(类似掘金、CSDN)。"道理我都懂了,但在一个真实项目里,这些东西是怎么组合在一起的?
2026-05-05 22:04:31
333
原创 2026年,8款让开发者上瘾的终端神器,你用过几个?
如果你经常要管理多台服务器、多个环境,Tabby 的"连接管理"功能能帮你省不少时间——保存好的 SSH 配置,点一下就连,不需要每次手敲。终端这个工具的演化方向很有意思——一边是越来越多的功能被塞进去(AI、预览、连接管理),另一边是 Alacritty 这样的极简主义者反其道而行之,用"减法"吸引一批忠实用户。"没有功能"反过来成了它的优势——依赖少、启动快、稳定、跨平台表现一致。这反而吸引了一批有很强工具定制能力的开发者,他们不需要终端自带功能,他们要的是一块性能可靠的"画布",自己在上面搭工作流。
2026-05-03 10:24:29
1256
原创 第16课:用了 Claude Code,怎么证明你变快了
因为你写的 prompt 更短(CLAUDE.md 承载了大部分规范)、返工更少(一次成功率更高)、自查减少了反复调整。每个案例都是完整的、可复现的、你可以直接参照着在自己的项目里操作的。使用 Claude Code 的第一周效率可能反而下降——因为你在学习新的工作方式。记两周就够了——一周用 Claude,一周不用(或者用之前的一周作为基线数据)。最后3课是实战篇——不再拆分知识点,而是用完整的项目案例把前面所有内容串在一起。如果你要说服团队或老板,最有说服力的方式是"同样的任务,两种方式对比"。
2026-05-02 22:55:47
606
原创 《AI 产品经理转型实战手册》AI 产品经理到底是不是新岗位?
以前你要理解模型、数据、训练、部署,才可能参与 AI 产品;所以,AI PM 不是推翻传统 PM,而是在传统 PM 的底座上,多了一层对 AI 能力、数据、模型边界和风险治理的理解。AI PM 不是凭空出现的新职业,也不是普通 PM 换个名字,而是传统产品经理能力在 AI 时代的一次系统升级。用户洞察、需求分析、流程设计、商业判断、项目推进、跨团队沟通,这些能力在 AI 产品里依然重要,甚至更重要。所以,AI PM 的争议,本质上不是“岗位名称”的争议,而是“产品经理是否需要升级能力边界”的争议。
2026-05-02 18:28:31
537
原创 为什么你3年React还是不懂JavaScript?|从框架的舒适区逃离
如果改变了顺序,setCount可能会改变name的state,因为闭包捕获的是"第一个useState的返回值",不管那个useState里存的是什么。这一个顿悟,让我理解了为什么useCallback的依赖数组那么重要、为什么useEffect的依赖数组那么重要。我那时的回答是:"因为……或者这个例子——我见过一个人,用了5年React和Redux,有天被问:"说说闭包在Hooks里的作用。我问他:"你有没有想过,也许不是React的问题,而是你对JavaScript本身的理解有gap。
2026-05-02 10:41:23
510
原创 第15课:3 个真实可用的 GitHub Actions,让 Claude 每天帮你自动做代码审查和安全扫描
但在 GitHub Actions 这种无人值守的 CI 环境里,它并不适合直接使用——CI Runner 是全新环境,没有持久的身份认证状态,也没法处理交互式提示。,全部基于 Anthropic 官方 Python SDK 实现——这是目前在 CI/CD 环境里最稳定的接入方式。实现分两个文件:一个 GitHub Actions YAML 负责触发流程,一个 Python 脚本负责调 API 和发评论。小团队就 1-2 个有审查能力的高级开发者,PR 排队是常态。核心思路:用 SDK,不是 CLI。
2026-05-01 22:49:16
564
原创 第14课:团队协作中的 Claude Code
更尴尬的是:你审查同事的 PR 时,Claude 帮你发现了一堆问题,但你每次都要解释"这个要按规范来"——而这些规范只存在于你的 CLAUDE.md 里,同事根本不知道。你的代码严格遵守了 CLAUDE.md 里的规范——命名一致、错误处理统一、测试齐全。学完之后:你能设计一套团队共享的 Claude Code 协作方案,并且知道怎么推广而不引起反感。第08课你给自己的项目写了 CLAUDE.md。你用 Claude 写的代码风格跟同事的越来越不一样。团队用的关键是第3层——项目级 CLAUDE.md。
2026-04-26 13:52:53
598
原创 2026前端人必须知道的6个MCP服务器,每一个都能省掉一个工具链
AI在里面执行Python脚本、跑Shell命令、做数据分析、出图表——所有这些都在隔离环境里,不碰你的本地机器,也不碰你的生产系统。GitHub MCP让你的AI可以直接和仓库交互——查Issue、看PR、浏览提交记录、搜索代码,全部用自然语言完成,不用离开你的AI对话界面。不是说不用MCP你就会被淘汰,而是会MCP的人,正在悄悄把重复性劳动从工作流里清零,把省下来的时间花在真正值钱的事情上。MCP现在的状态,有点像2015年的npm生态——基础设施已经就绪,工具在快速爆发,但真正把它用好的人还是少数。
2026-04-26 10:23:22
926
原创 《AI 产品经理转型实战手册》介绍
AI 助手产品怎么设计;AI 产品 MVP 怎么设计;AI 产品到底是什么;AI 产品上线怎么验收;AI 产品核心指标怎么设计;传统产品经理怎么转 AI PM;普通互联网人怎么补齐 AI 产品能力;什么是真正的 AI 产品;AI、机器学习、大模型、RAG、Agent 到底分别解决什么问题;比如 AI 知识库、AI 智能客服、AI 助手、AI Agent、AI 写作工具、AI 教育产品。从 AI 产品认知,到 AI PRD;它不会把你变成算法专家, 但会帮你成为一个更懂 AI、更懂产品、更懂落地的产品人。
2026-04-25 21:48:13
566
原创 资深工程师必知的7个JavaScript AI库(让AI开发不再复杂)
TensorFlow.js 是 TensorFlow 的 JavaScript 绑定,允许你用 JS 写完整的 ML 管道:数据加载 → 模型定义 → 训练 → 推理。Transformers.js 是由 Hugging Face 开源的库,让你可以直接在 JavaScript 环境中加载和运行预训练模型。如果说 TensorFlow.js 是"完整的 ML 平台",那 Brain.js 就是"开箱即用的神经网络"。LangChain 相当于说:"这些通用的'管道',我都给你写好了,你只需要组装。
2026-04-25 12:25:54
569
原创 第13课:日常开发工作流,从晨会到代码提交
我会用一个开发者完整的一天来演示:从早上打开电脑到晚上提交代码,每个环节怎么用 Claude Code。:新的分页逻辑在最后一页数据不足一页时,游标指向了不存在的记录,下一次查询尝试读取这条记录的。任务1:用户中心用的是 NestJS 的标准模块结构,有个 profile 模块可以参照。Claude 会同时启动多个 Explore Agent,分别扫描三个任务涉及的代码。:先看看第一个任务的需求文档,翻翻相关代码,脑子里过一遍大概要改哪些文件。但真正的效率提升不在于"单个任务快了3倍",而在于——
2026-04-22 23:49:19
578
原创 第12课:MCP 与 Hooks——给 Claude Code 装上插件和自动化引擎
你的手机出厂时能打电话、发短信。装了微信就能聊天,装了高德就能导航,装了支付宝就能付款。学完之后:你能给 Claude Code 装上持久记忆、数据库查询、GitHub 集成等插件,并配置自动化触发。不设的话,所有项目会共用一个记忆文件——你在A项目存的"用 Redis 做缓存",会出现在B项目的上下文里。安装完之后,Claude 就会自动检测到新的 MCP Server,你不需要额外配置。:Claude 每次对话都是全新的,不记得上次聊了什么。= 给 Claude Code 装插件,扩展它能做的事。
2026-04-20 22:52:45
708
原创 我们花了 3 个月迁移到 TypeScript,这是值得的吗?
TypeScript 一开始就抱怨:"你这不是真正的 User 类型。更重要的是,那些数据结构相关的 bug——就是那些"字段名不匹配"、"类型错了"的 bug——几乎消失了。那一周里,我们修了三个类似的"跨界 bug"。有人说"好主意",也有人说"不就是加个冒号吗,有那么重要?于是,我们用 3 个月完成了从 JavaScript 到 TypeScript 的迁移。TypeScript 不会让你成为更聪明的程序员,但它会让你更自信。类型签名自动文档化了接口,我们不用反复问"这个参数是什么"。
2026-04-11 20:23:48
594
原创 第11课:Multi-Agent 实战,并行编排的5种模式
就像你知道公司有前端、后端、测试、安全这些岗位,但让你当项目经理去调度他们同时工作——谁先做、谁后做、哪些可以同时进行、怎么合并结果——这是另一种能力。"扫描所有东西"不如"扫描认证流程"+"扫描数据模型"+"扫描API接口"来得有效。怎么编排多个 Agent 并行工作,把任务完成时间从"所有子任务耗时之和"压缩到"最慢那个子任务的耗时"。学完之后:面对任何复杂任务,你能设计出最优的 Agent 编排方案——该串行的串行,该并行的并行。从"一个人干活"到"指挥一个团队"从"一个人干活"到"指挥一个团队"
2026-04-11 11:40:40
608
原创 第10课:Agent 体系,认识你的 AI 团队成员
打个比方:你是项目经理(导演),Claude 的主对话是你的助理,Agent 们是你的团队成员。你跟助理说"安排三个人同时做这三件事",助理就会派出三个 Agent,做完之后把结果汇总给你。适合人群:已掌握核心技能篇,准备解锁 Claude Code 更深层能力的开发者 学完之后:你会知道 Claude Code 里有哪些"专业角色"可以调用、每种角色擅长什么、怎么调用。你只需要用自然语言告诉 Claude 你要做什么,Claude 会自动判断该派哪种 Agent、用什么模型。
2026-04-06 22:09:44
563
原创 第09课:10个高频场景 Prompt 模板库,复制、改几个词、直接用
这些模板不是拐杖,是脚手架——它帮你快速搭起骨架,等你熟练了,拆掉脚手架你也能写得一样好。写"支付回调有 bug"不如写"支付成功但订单状态没更新"——前者已经下了结论,后者只描述症状。"参照XXX的代码结构"这句话是整个模板里最省力的一句——它替代了你手动描述文件结构、命名风格、分层方式的工作。"排查方向"写"供参考,不限于此"——不要限制 Claude 的排查范围,你想到的方向可能不是真正原因。从"理解方法论"到"条件反射般写出好 prompt",中间需要大量的实践来形成肌肉记忆。,理解它在控制什么。
2026-04-05 21:13:36
623
原创 第08课:CLAUDE.md,让 Claude 永远记住你的规矩
比如项目级写了"TypeScript 严格模式",订单模块级写了"金额用整数(分)计算",Claude 在处理订单模块时两条都会遵守。你不会每次分配任务都从"我们用什么技术栈、代码风格是什么、错误处理怎么写"开始讲——你会说"先看完入职手册,然后来做这个任务"。但这个机制导致了一个问题:你的 prompt 有一半篇幅在写"背景信息和项目规范",只有另一半在写"这次要做什么"。每个 prompt 里都要写"参照XXX的风格""用现有的错误处理方式""不要引入新依赖"。这些话你写了几十遍了。
2026-04-04 20:25:58
642
原创 《Claude Code 从入门到精通》第07课:结果验证——你最不能省的一步
我会给你一套完整的验证体系——不是"检查一下有没有 bug"这种模糊建议,而是5个具体维度、每个维度的检查方法、可以直接嵌入 prompt 的验证指令、以及怎么让 Claude 在交付之前自己先做一轮质检。:有人发现,把请求 URL 里的用户 ID 改成别人的 ID,就能看到别人的数据。虽然加了"是管理员"的校验,但没有校验"这个管理员有没有权限看这个用户的数据"——在分权管理的系统里,A区域的管理员不应该看到B区域用户的数据。你测试了一下——选了一个时间范围,点导出,文件下载了,打开一看,数据都在。
2026-04-01 21:41:34
549
原创 「5 个 Markdown 文件 + 1 句提示词」让 AI 精准重构你的 React 组件 | 附完整模板
AI 就像一个新来的实习生:如果你只甩给他一个组件说"帮我改",他没有背景知识、没有项目约定、不知道你的底线在哪儿,改出来的东西自然南辕北辙。一行行列下来,AI 可能记住了 1、2、3,但在真正写代码的时候,面对一个复杂的决策点,它往往会忘记 4、5 的重要性。而真正高效的用法是把它当成"你的开发团队"——你说清楚要什么结果,它自己规划、自己执行、自己验证,一轮对话搞定。在评论区分享一下你的"AI 踩坑记"。找 3-5 个"做得好"的组件和 3-5 个"做得不好"的,放进去就行。
2026-03-29 18:46:00
662
原创 你的 React 应用真的需要依赖注入吗?深度对标 3 种架构方案
你的团队刚刚遇到一个经典的 React 问题:组件树里层层传递数据,父组件一改,十多个中间组件跟着改,太累了。有人建议用 Context API,有人提了依赖注入(DI)的概念,还有人说干脆用 Service Locator……维护这样的代码,每次改一个 prop 的名字或结构,你得改 5 个无关的组件。(路由状态、用户会话等) → 用专门的状态库,不要硬塞进 Context。这是一个来自后端(特别是 Java、.NET)的设计模式。与其说"我需要什么,你就给我什么",不如说"我去服务市场里自己拿"。
2026-03-29 12:34:10
532
原创 第06课:让 Claude 自己分配任务——并行 Agent 策略
当你给 Claude 一个包含多个独立子任务的 prompt 时,Claude Code 可以启动多个 Agent,每个 Agent 独立处理一个子任务。比如"给 user.service.ts 加邮箱验证"和"给 user.service.ts 加手机号验证"——两个 Agent 同时改同一个文件,最后合并的时候可能互相覆盖。比如"先设计数据库表,再基于这个表写接口"——接口的代码取决于表的字段设计。它先做 A,A 做完做 B,B 做完做 C。这是从"2x效率"跳到"5x效率"的关键。
2026-03-29 12:34:10
562
原创 《Claude Code 从入门到精通》目标优于指令,Director Mode 第一支柱(五)
不夸张——仅仅是把 prompt 从"指令型"改成"目标型",在很多场景下效果差距有3倍以上。你说"正确处理非法金额",Claude 会考虑你没想到的边界情况。你想到了检查"大于0",Claude 就只检查"大于0"。学完之后:面对任何开发任务,你能把"指令型 prompt"改写成"目标型 prompt",效果提升立竿见影。当你用 Claude Code 的时候,你的本能反应是把脑子里的分解步骤一步步告诉它。转变的关键不是学新技巧,而是憋住——憋住"告诉它怎么做"的冲动,只说"要什么"但还不够你"用得好"
2026-03-28 22:35:21
390
原创 《Claude Code 从入门到精通》试读篇:当 Claude 理解错了怎么办(四)
这节课用5个完整的开发场景,逐字演示怎么把"指令型 prompt"改写成"目标型 prompt"——功能开发、Bug修复、代码重构、安全审查、性能优化,每个场景都给你改写前后的完整对比和效果差异。如果你追加了3轮指令,问题不但没解决还越改越乱,说明第一轮的基础就是歪的。这些"忘了"不是你的错,是因为这些规范"活在你的脑子里",你觉得理所当然,但 Claude 不知道。出发点是好的,但在你没有预期的情况下,这些改动会带来风险——尤其是那些它觉得"顺手"的重命名和重构,很可能影响到你没有关注的其他模块。
2026-03-25 21:25:32
604
原创 《Claude Code 从入门到精通》试读篇:写好 Prompt 的结构化思维,10组正反对比,看完直接套用(三)
因为在实际使用中,"做什么"和"背景是什么"混在一起写,是 prompt 质量差的头号原因。你以为你在给背景,其实你在下指令。因为是从零开始做,没有"案发现场"需要描述,但需要把"做成什么样"和"不要做成什么样"说清楚。有的人试完觉得"确实快",也有人跟我说"我写了 prompt,Claude 做出来的东西不太对"。跟第02课比,变化是:把"具体需求"拆成了"目标描述"和"上下文信息"两个独立要素。很多时候 Claude 给你的代码"技术上是对的,但不是你想要的",原因就是你没告诉它边界在哪。
2026-03-24 21:11:46
600
原创 附录篇:全套模板汇总 + 一周落地计划 + 常见问题
📌 本篇定位:这是你的"工具箱"。所有可直接复制使用的模板、一份按天拆解的落地计划、以及 10 个最常被问到的问题。下面按使用顺序排列,每份标注用途和推荐优先级。三、模板 2:CLAUDE.md 进阶增强版(追加模块)二、模板 1:CLAUDE.md 最小可用版。判断规则该不该写进 CLAUDE.md。适合刚开始搭建的项目。CLAUDE.md 最小可用版。CLAUDE.md 进阶增强版。占位符替换成你的真实信息。项目规则入口(成熟项目)项目规则入口(起步用)发布前/发布后检查清单。Hooks 配置示例。
2026-03-23 20:31:22
315
原创 《Claude Code 从入门到精通》试读篇:你的第一次 Director Mode 体验(二)
我把过去半年用 Claude Code 做内容型项目踩过的坑、总结出的方法,写成了一本完整的实战手册,包含 6 篇深度正文 + 14 份可直接复制使用的模板:。注意"中国大陆手机号"这个细节——如果你只写"验证手机号",Claude 可能给你一个国际通用的格式,不一定适合你的业务场景。先用操作者模式做,再用导演模式做。因为你一步步给指令,Claude 的视野被限制在"你当前让我看的这一个文件"里。,因为你的 prompt 里写了"查看项目中现有接口的验证方式和错误响应格式,保持一致"。
2026-03-22 22:14:25
381
原创 第 6 篇:从文件到系统,CLAUDE.md 与 hooks、subagents 的协作升级
CLAUDE.md 里的规则,Claude 遵守的概率是 70%-95%(取决于规则清晰度和上下文复杂度)。而 hooks 执行的概率是 100%——因为它不是靠 Claude "记住",而是由系统自动触发。Hooks 是 Claude Code 提供的自动化机制——在 Claude 工作流的特定节点,自动运行你预设的脚本或命令。这就是 hooks 和 subagents 的作用——把"Claude 应该做的事"变成"系统自动做的事"。所有规则的执行,都依赖 Claude "记住并遵守"。
2026-03-22 12:46:02
361
原创 为什么传统编程在消亡(但工程师不会):深度解析 AI 时代的 5 大职业转机
从 2020 年我开始接触 AI 辅助开发,到如今 Claude Code、GitHub Copilot 这样的 AI Agent 能做架构级别的改动,我看到的是一场从根本上改变开发流程的革命。看到这标题时,很多人的反应是两极的——要么觉得是耸人听闻,要么开始焦虑自己的职业前景。和 AI 一起工作,但始终保持清醒的头脑——知道什么时候该让 AI 执行,什么时候该自己思考。比如,当你让 Claude Code 修复一个 bug 时,它不是简单地匹配"错误信息"→"通用解决方案"。
2026-03-22 10:27:11
577
原创 《Claude Code 从入门到精通》试读篇:Claude Code 是什么?你可能从第一步就用错了
你不需要告诉他们每一行代码怎么写,你告诉他们做什么、有什么约束、什么叫做完了。关键区别:你没有手动分解"先查什么、再查什么"——你描述了问题和期望,Claude 自己规划了排查路径。你自己把需求拆成子任务,一个模块一个模块去改,来回跟 Claude 沟通十几次,很容易漏掉边界情况。我说你这个用法,就像买了一辆越野车,然后每天只在小区里接孩子——能用,但你花的钱大部分都白花了。Copilot 帮你"打字更快",Claude Code 帮你"思考和执行"。Claude 只是一个执行者——你说一步,它做一步。
2026-03-21 22:04:14
313
原创 第 5 篇:让 Claude 少犯错,验证机制、测试策略与发布检查清单
但改一篇内容的 category 字段,你不一定能立刻想到它会影响:分类聚合页的内容列表、侧边栏的分类计数、搜索索引中该文章的分类标记、可能存在的 RSS 分类过滤。你按前四篇的方法,搭了一套完整的规则体系——CLAUDE.md 主文件、6 份 docs/ 文档、frontmatter 规范、schema 定义、构建链路说明。即使是人类开发者,代码审查、单元测试、CI/CD 也不是因为"不信任开发者",而是因为"人会犯错,系统来兜底"。这三个特点决定了:内容型项目的验证策略,不能照搬代码项目的做法。
2026-03-21 21:19:11
356
原创 第 4 篇:内容即数据——frontmatter 规范、数据结构与构建链路的工程化设计
你的 docs/content-rules.md、docs/data-schema.md 和 docs/build-process.md 的核心任务,就是把这些"隐性连锁关系"变成"Claude 能看到的显性规则"。一旦某个字段进入了"基础字段"清单,就不要轻易改动它。因为改动一个基础字段,意味着你需要同时更新:所有内容文件、类型定义、解析函数、页面模板、搜索索引脚本——任何一个环节遗漏,都会出问题。很多人在早期会省略这个字段,结果列表页的摘要显示要么是空的,要么是用正文前 100 字截取的——效果很差。
2026-03-20 22:01:21
319
原创 第 3 篇:规则分层——用 docs/ 文档体系实现渐进披露
不是因为它"叛逆",而是因为——回忆第 1 篇讲的"指令预算"概念——当信息量超过阈值后,Claude 对所有规则的遵守力度都会均匀下降。📌 本篇核心目标:学会把"一个膨胀的 CLAUDE.md"拆解为"一个精简的主文件 + 一套专项文档",掌握 6 份 docs/ 文档各自的职责边界,以及如何让 Claude 按需加载而非全量灌入。它管的是内容的"形式规范"——不是内容写什么(那是编辑的事),而是内容的文件结构、命名方式、字段规则、分类标签使用规则。它先给你一个导航,你根据当前任务找到对应的文档。
2026-03-19 22:22:08
583
原创 第 2 篇:从零搭建一份内容型知识库项目的 CLAUDE.md 实战编写
自动生成的内容往往偏冗余。而且它几乎不可能自动识别内容型项目的特殊规则——比如 frontmatter 约束、slug 规则、分类体系的设计逻辑。Claude 会扫描你的项目——看 package.json、tsconfig、目录结构、现有文档——然后自动生成一份 CLAUDE.md 初稿。这是 CLAUDE.md 的第一段,Claude 进入项目后最先看到的内容。最好的 CLAUDE.md 不是一次写完的,而是在真实使用中逐步长出来的。:对项目很熟悉的人、想完全掌控内容的人、不想引入自动生成冗余的人。
2026-03-18 21:46:00
482
原创 第 1 篇:重新理解 CLAUDE.md——它不是文档,而是项目协作的配置中枢
最糟的是——有时候你忘了交代某个关键约束(比如"slug 不能改"),Claude 就真的把 slug 改了,导致页面 URL 断裂、搜索索引失效、内链全部 404。📌 本篇核心认知:CLAUDE.md 不是给人看的说明文档,而是给 Claude 用的项目级配置文件。它假设读者是一个新加入项目的人类开发者,需要了解项目背景、怎么安装、怎么运行、架构是什么样。大多数开发者第一次听到 CLAUDE.md,会本能地把它和 README.md 归为一类——"不就是个项目说明文件嘛"。你是不是也在重复做这件事?
2026-03-17 22:56:07
463
空空如也
空空如也
TA创建的收藏夹 TA关注的收藏夹
TA关注的人
RSS订阅