手把手教你写第一个 Claude Code 技能（Skill）：一个能帮你省几十个小时的项目记忆系统

📌 一句话摘要

本文手把手教你为 Claude Code 构建一个「项目记忆」技能，通过结构化 Markdown 文件解决 AI 会话间失忆问题，并注入 CLAUDE.md 实现自动记忆检索。

📝 详细摘要

文章从开发者普遍面临的「AI 失忆症」切入——每次新会话 AI 都忘记之前解决过的问题，导致重复劳动和隐性成本。作者估算每周浪费 30 分钟、一年 26 小时、按 $100/小时算约 $2，600。随后介绍 Claude Code 的 Agent Skill 机制（SKILL.md + 触发条件），并完整展示「project-memory」技能的设计：在 docs/project_notes/ 下创建 bugs.md（Bug 数据库）、decisions.md（架构决策记录）、key_facts.md（项目配置要点）、issues.md（工作日志）四个文件。核心巧妙之处在于通过修改项目的 CLAUDE.md 注入「记忆意识」协议，让 Claude 在提出方案或遇到错误时自动查询记忆文件，无需用户手动触发。文章还给出了真实效果对比（Bug 修复从 45 分钟降至 5 秒），并分享了设计哲学：AI 记忆应藏在人类可读的 Markdown 中，而非 embedding 向量里。

💡 主要观点

- AI 会话间失忆是开发者隐性成本的主要来源。 每次新会话 AI 忘记之前解决过的问题，导致重复调试。作者估算每周浪费 30 分钟，一年 26 小时，按 $100/小时算约 $2，600。

Agent Skill 通过 SKILL.md 实现按需激活的专家模式。 Skill 是一个文件夹，包含 YAML frontmatter（触发条件）和 Markdown 正文（指令）。Claude 只在匹配请求时加载完整指令，不影响日常交互。

项目记忆技能的核心是结构化 Markdown 文件 + CLAUDE.md 注入。 在 docs/project_notes/ 下创建 bugs.md、decisions.md、key_facts.md、issues.md 四个文件，并通过修改 CLAUDE.md 让 Claude 自动在决策或调试前查询这些文件。

AI 记忆应藏在人类可读的 Markdown 中，而非 embedding 向量里。 作者强调记忆文件应像标准工程文档，让开发者和 AI 都能读、能改、能理解，避免黑盒化。

💬 文章金句

- AI 的记忆不应该藏在 embedding 向量里，而应该藏在人类可读的 Markdown 文件里。

• 让记忆文件看起来像标准工程文档——这样其他开发者（不管用不用 AI）都会自然地维护它。

📊 文章信息

AI 初评：87

来源：王俊博客

作者：王俊博客

分类：人工智能

语言：中文

阅读时间：11 分钟

字数：2735

标签： AI 编程, Claude Code, Agent Skill, 提示工程, 开发者工具

阅读完整文章