企业官网建设流程全解析

这几年做 AI 辅助开发，我最大的感受是：单次对话里让模型写一个函数、修一个报错很容易，一旦工作规模变大——比如“把这个旧系统迁移到新架构”“实现一个包含登录、权限、订单的完整模块”——单次会话根本装不下。任务做到一半上下文就乱了，新开会话又得重新解释背景，模型给出的方案经常前后矛盾。

最近看了 Matt Pocock 分享的 wayfinder skill 实战思路，发现他处理的正是这个痛点：通过一个可复用的 skill，让 AI 在多个会话之间保持对目标的统一理解，并且把任意规模的工作拆成一份可持续跟踪的“路线图”。这篇文章我会围绕 wayfinder skill 展开，先说明它解决什么问题，再带你从零搭建一套可用的跨会话规划方案，最后给出常见问题和工程建议。

无论你是 AI 编程的重度用户，还是想用 Claude 这类智能体来管理个人项目、开源任务、团队需求，这篇文章的思路都适用。

1. 背景与核心概念

1.1 什么是 Agent Skill

在继续之前，先明确一个概念：Agent Skill（智能体技能）。

你可以把 Skill 理解成“预置给 AI 的一套专业工作手册”。它不是一个普通的提示词模板，而是一个带有目录结构的文件夹，里面可能包含：

• 一个SKILL.md文件，描述这个技能的用途、触发条件和执行步骤；
• 若干参考文档、示例代码；
• 一些可执行的脚本或工具。

当 AI 识别到当前任务符合某个 Skill 的描述时，它会自动加载这套手册，按照手册规定的流程来工作。好处是显而易见的：工作流程被固化了，AI 不会每次凭感觉自由发挥，产出质量更稳定。

wayfinder skill 就是这类技能中的一种，只不过它专注的方向是“规划”。

1.2 跨会话规划要解决什么问题

大语言模型的上下文窗口虽然越来越大，但它并不是无限长的。当你让 AI 处理一个持续数天、甚至数周的项目时，会遇到三个很现实的问题：

第一，上下文溢出。所有历史记录都塞在一个会话里，很快就会超过模型的处理上限，AI 开始“遗忘”早期信息。

第二，状态丢失。新开会话后，AI 不再记得之前的决定、已完成的步骤、待办事项，你需要花大量时间重新描述背景。

第三，目标漂移。如果每个会话都由 AI 临时发挥，很容易出现方案不一致的情况，尤其是当你不小心用了不同的措辞描述同一需求时。

跨会话规划的思路是：不把项目的全部状态放在 AI 的记忆里，而是放到外部文件中。AI 每次会话开始时读取这些文件，结束时更新这些文件。项目状态从一个会话“传递”到下一个会话，AI 始终知道自己做到哪一步。

1.3 wayfinder skill 在其中的位置

wayfinder 这个名字很有意思，直译是“探路者”。它的职责就像队伍里负责看地图、定路线的那个人：不具体搬砖，但保证每一步都知道往哪儿走。

放在 AI 工作流里，wayfinder skill 的核心职责包括：

• 理解用户给出的高目标；
• 把目标拆解成可执行的阶段和任务；
• 生成一份可持续更新的项目计划文件；
• 在任务的每个节点记录进度、状态、风险；
• 新会话启动时，基于计划文件快速恢复上下文。

如果你熟悉项目管理，会发现它很像一个轻量级的项目管理方法论：有目标、有阶段、有任务、有状态追踪。只不过执行者是 AI，维护者是 AI 加你共同完成。

2. 环境准备与版本说明

在开始搭建设计之前，先把环境和准备工作理清楚。

2.1 运行环境说明

wayfinder skill 本身不依赖特定的操作系统，它本质上是文件加规则。你可以在 Windows、macOS、Linux 上使用，只要你的 AI 工具支持自定义 Skill 机制即可。

以当前主流的 Claude 生态为例，Agent Skills 通常放在以下目录：

~/.claude/skills/ # 用户级技能，所有项目可用 ~/.claude/projects/ # 项目级配置 ./.claude/skills/ # 项目级技能，放在项目根目录

和传统插件的区别在于：Skill 不需要编译、不需要安装依赖，只要你把文件夹放到指定位置，AI 就能识别。

2.2 版本与兼容性说明

注意，Agent Skills 功能仍在快速演进中，不同版本的客户端对 Skill 的支持程度可能不同。本文示例基于以下假设：

• 你使用的 AI 工具支持自定义 Skill 目录（当前 Claude 桌面端与 CLI 环境均有对应支持）；
• 你的模型版本支持读取本地文件；
• 你拥有可用的订阅或 API 权限。

如果你的工具版本不支持某种写法，请以官方文档为准。重点是理解 wayfinder skill 的设计模式，而不是死记某一个文件夹路径。

2.3 准备工作清单

在动手前，建议准备：

1. 一个用于测试的空项目文件夹，例如wayfinder-demo；
2. 你常用的 AI 客户端，能配置自定义 Skill；
3. 一个真实的、规模适中的目标任务，不要用“写个 Hello World”这种太简单的任务，至少要包含三四个步骤，才能感受到规划的价值；
4. 基本的命令行操作能力，会创建文件夹、编辑 Markdown 文件即可。

3. 理解 wayfinder skill 的核心设计

在写具体代码之前，我们先把 wayfinder skill 的工作原理讲透。如果只复制文件不理解机制，遇到问题你还是不会排查。

3.1 状态外置

wayfinder skill 最关键的设计原则是“状态外置”。AI 的记忆是不可靠的，但文件是可靠的。

我们约定一个固定的状态目录，例如wayfinder/state/，里面存放：

• goal.md：目标描述，一句话说清楚要完成什么；
• plan.md：完整计划，包含阶段划分、任务列表、依赖关系；
• progress.md：进度跟踪，记录当前进行到哪一步、阻塞在哪、下一步做什么；
• decisions.md：决策日志，记录重要决定的背景和结果。

这四个文件的职责划分非常明确：

• 目标是锚点，防止 AI 跑偏；
• 计划是地图，告诉 AI 有哪些路径；
• 进度是当前位置，告诉 AI 已经在哪儿；
• 决策日志是历史，告诉 AI 为什么这样做。

当 AI 开始工作时，它先读取这四个文件；当它完成一个阶段时，它同步更新这四个文件。新会话启动后，同样先读取再继续。状态就这样跨会话地延续下来了。

3.2 任务分解的粒度控制

很多人在让 AI 规划时会犯一个错误：把任务拆得太粗，或者拆得太碎。

拆得太粗，AI 面对一个“实现用户模块”的任务时依然无从下手；拆得太碎，比如“点击按钮”“弹出提示框”这种级别也写进计划里，会让计划文件无比臃肿，AI 加载效率变低。

wayfinder skill 推荐一种分层结构：

目标（goal） └── 里程碑（milestone） └── 任务（task） └── 子步骤（subtask，可选）

在plan.md文件中，只需要维护到“任务”级别，具体到“子步骤”时，让 AI 在真正执行该任务的那个会话里去展开。这样既保证了全局视野，又不让计划文件过度膨胀。

用实际项目来举例。目标是“把博客从 WordPress 迁移到 Astro”，那么计划可以写成：

里程碑 M1：内容迁移 任务 M1-T1：导出 WordPress 文章与图片 任务 M1-T2：清洗 Markdown 格式 任务 M1-T3：建立文章目录结构 里程碑 M2：主题开发 任务 M2-T1：搭建 Astro 项目骨架 任务 M2-T2：设计首页布局 ...

这种粒度，AI 在任何一个会话里都能清晰地知道自己正在处理哪一块，又不会被大量实现细节淹没。

3.3 会话启动与收尾流程

wayfinder skill 要求 AI 在每次会话时执行一个固定的流程，通常写在SKILL.md中。这个流程大致是这样的：

会话启动时：

1. 读取goal.md，确认项目目标；
2. 读取plan.md，确认整体计划；
3. 读取progress.md，确认当前进度；
4. 读取decisions.md，了解历史决策；
5. 根据这些信息，向用户汇报“当前状态 + 建议的下一步”。

会话进行中：

1. 每完成一个任务，就更新progress.md；
2. 如果发现计划不合理，修改plan.md并记录原因；
3. 如果做了重要决定，追加到decisions.md。

会话结束时：

1. 更新progress.md，写清当前完成到哪一步；
2. 如果有遗留问题或风险，写进progress.md的“风险”区域；
3. 推荐下一步可以开一个新会话继续。

这套流程确保了一个会话的结束不是项目的中断，而是下一个会话的起点。

4. 完整实战：从零搭建 wayfinder skill

接下来我们实际动手。我会带你创建一个最小可用的 wayfinder skill，并用一个示例任务做全流程演示。

4.1 创建项目目录结构

首先，在测试目录里创建项目结构和技能目录：

mkdir -p wayfinder-demo/.claude/skills/wayfinder mkdir -p wayfinder-demo/wayfinder/state cd wayfinder-demo

目录说明：

• .claude/skills/wayfinder/：存放 skill 定义文件；
• wayfinder/state/：存放当前项目的规划状态文件。

你也可以把 skill 放在用户全局目录~/.claude/skills/，这样所有项目都能用。实际项目中更推荐先放项目目录，验证没问题后再考虑全局化。

4.2 编写 SKILL.md 核心文件

在.claude/skills/wayfinder/下创建SKILL.md。这是 skill 的核心，AI 会通过它来理解你希望它如何工作。

--- name: wayfinder description: 用于跨会话规划和管理任意规模的工作。当用户提出一个复杂的、多步骤的目标，或希望跟踪项目进度时，使用本技能。 --- # wayfinder skill 你是一个项目规划与进度管理专家。你的目标是在多个会话之间维持对项目目标的统一理解，持续跟踪进度，并保证任务持续推进。 ## 工作方式 1. 在启动任何任务之前，先读取状态目录中的四个文件： - wayfinder/state/goal.md - wayfinder/state/plan.md - wayfinder/state/progress.md - wayfinder/state/decisions.md 2. 如果这些文件不存在，先向用户确认目标，然后初始化这几个文件。 3. 每次会话开始，向用户汇报： - 目标：一句话复述当前目标； - 进度：当前完成到哪一步； - 下一步：建议接下来处理哪个任务。 4. 每次会话中，完成一个任务后立即更新 progress.md。 5. 每次会话结束前，更新 progress.md 与 decisions.md。 ## 计划文件格式 plan.md 使用以下格式：

项目计划

目标

（来自 goal.md）

里程碑

M1：里程碑名称

• [ ] M1-T1：任务描述
• [ ] M1-T2：任务描述

M2：里程碑名称

• [ ] M2-T1：任务描述

## 进度文件格式 progress.md 使用以下格式：

进度跟踪

当前状态

• 开始日期：
• 预计结束日期：
• 完成里程碑：
• 当前里程碑：

任务状态

• [x] M1-T1：任务描述（完成日期）
• [ ] M1-T2：任务描述（进行中）
• [ ] M1-T3：任务描述（未开始）

阻塞与风险

• （无）

下一步

## 原则 - 不要在没有确认目标的情况下直接开始规划。 - 计划必须可执行，每个任务都要有明确的完成标准。 - 如果任务规模很小且可以在一次会话中完成，不必强行使用本技能。

这个文件是 wayfinder skill 的行为核心。它规定了 AI 如何在会话之间传递信息。

4.3 编写辅助脚本（可选）

Markdown 文件已经足够完成大部分工作，但如果你希望状态更新更规范，可以写一个简单的 shell 脚本，用于初始化状态目录。

创建scripts/init-wayfinder.sh：

#!/usr/bin/env bash # 初始化 wayfinder 状态目录 set -euo pipefail STATE_DIR="wayfinder/state" if [ ! -d "$STATE_DIR" ]; then mkdir -p "$STATE_DIR" fi if [ ! -f "$STATE_DIR/goal.md" ]; then cat > "$STATE_DIR/goal.md" << 'EOF' # 项目目标 （在这里描述你的目标。要求具体、可衡量、有时限。） EOF fi if [ ! -f "$STATE_DIR/plan.md" ]; then cat > "$STATE_DIR/plan.md" << 'EOF' # 项目计划 ## 目标 （来自 goal.md） ## 里程碑 ### M1：第一个里程碑 - [ ] M1-T1：第一个任务 EOF fi if [ ! -f "$STATE_DIR/progress.md" ]; then cat > "$STATE_DIR/progress.md" << 'EOF' # 进度跟踪 ## 当前状态 - 开始日期： - 预计结束日期： - 完成里程碑： - 当前里程碑： ## 任务状态 - [ ] M1-T1：第一个任务（未开始） ## 阻塞与风险 - （无） ## 下一步 - 等待用户确认目标 EOF fi if [ ! -f "$STATE_DIR/decisions.md" ]; then cat > "$STATE_DIR/decisions.md" << 'EOF' # 决策日志 记录项目中重要的决策和原因。 | 日期 | 决策 | 原因 | | --- | --- | --- | | （日期） | （决策内容） | （决策原因） | EOF fi echo "wayfinder 状态目录初始化完成：$STATE_DIR"

然后给它执行权限：

chmod +x scripts/init-wayfinder.sh

这个脚本不是必须的。它的价值在于：当你要开始一个新项目时，不用手动创建四个文件和模板，一条命令就能搞定。

4.4 初始化一个实际任务

现在我们来跑一个实际任务。为了演示效果，我选一个中等复杂度的目标：“为一款待办事项 Web 应用编写完整的后端 API，包含用户注册、登录、任务 CRUD，并输出 API 文档”。

先执行初始化脚本：

./scripts/init-wayfinder.sh

然后打开wayfinder/state/goal.md，填入目标：

# 项目目标 为一款待办事项 Web 应用编写完整的后端 API，包含用户注册、登录、任务增删改查，并输出 API 文档。技术栈为 Node.js + Express + SQLite，要求接口有基础的认证保护。

接着打开wayfinder/state/plan.md，我们手动把初始计划拆出来。这一步你也可以让 AI 帮你拆，但为了演示方式，我直接给你看一个合理的结果：

# 项目计划 ## 目标 为一款待办事项 Web 应用编写完整的后端 API，包含用户注册、登录、任务增删改查，并输出 API 文档。技术栈为 Node.js + Express + SQLite。 ## 里程碑 ### M1：项目基础搭建 - [ ] M1-T1：初始化 Node.js 项目并安装 Express、sqlite3 依赖 - [ ] M1-T2：搭建项目目录结构（routes、controllers、db、middleware） ### M2：用户认证 - [ ] M2-T1：创建用户表结构 - [ ] M2-T2：实现注册接口（密码加密存储） - [ ] M2-T3：实现登录接口（返回 JWT Token） - [ ] M2-T4：实现认证中间件 ### M3：任务管理 - [ ] M3-T1：创建任务表结构 - [ ] M3-T2：实现任务的创建、查询接口 - [ ] M3-T3：实现任务的更新、删除接口 ### M4：文档与收尾 - [ ] M4-T1：编写 README 与 API 文档 - [ ] M4-T2：编写基础测试用例

这个计划并不算特别复杂，但它已经足以体现 wayfinder skill 的价值。你会看到 AI 在后面工作时，能清晰地知道自己处于哪个里程碑。

4.5 在 AI 工具中调试和验证

现在把整个wayfinder-demo文件夹作为项目目录打开。

在 AI 工具中开启一个新对话，输入：

请使用 wayfinder skill。我们现在开始项目，当前处于第一步。

再看看 AI 的回复。理想情况下，AI 会先读取SKILL.md，然后读取四个状态文件，并输出类似这样的内容：

我已加载 wayfinder skill。 当前目标：为待办事项应用编写完整的后端 API，包括用户注册、登录、任务 CRUD。 当前进度：项目管理状态已初始化，计划已拆分为 4 个里程碑、10 个任务，当前还没有任务开始执行。 建议下一步：处理 M1-T1，初始化 Node.js 项目并安装依赖。是否现在开始？

如果 AI 给你的是这段话，说明 wayfinder skill 已经被正确识别并激活。

接下来你只需要回复“开始”，AI 就会按照计划执行，并在完成一个任务后更新wayfinder/state/progress.md。会话结束后，你关掉对话，第二天新开一个会话，再次说“继续”，你会发现 AI 能准确接上昨天的进度。

5. 在 Claude 项目中配置 wayfinder skill

如果你使用的是 Claude 项目功能，还可以把 wayfinder skill 与项目级配置结合得更紧密。

5.1 创建项目级 CLAUDE.md

在项目根目录创建.claude/CLAUDE.md，写入以下内容：

# 项目说明 本项目使用 wayfinder skill 进行跨会话规划。 - 如果用户提到“规划”“继续”“记录进度”“下一步”，默认使用 wayfinder skill。 - 状态文件保存在 wayfinder/state/ 目录下。 - 每次会话开始，先读取 wayfinder/state/ 下的状态文件。 - 会话结束前，确保进度文件已更新。

这样 AI 在启动时会自动把 wayfinder skill 当作项目的默认工作方式，不需要每次手动声明。

5.2 配置 .gitignore

如果项目使用 Git 管理，建议把不必要上传的内容排除掉。但注意，状态文件是否入库需要根据项目情况决定。

个人项目推荐把状态文件也提交到 Git，这样你有一份历史记录，可以回溯目标的变更过程。如果是团队项目，也可以选择提交，便于成员了解项目进度。

如果你不希望提交，可以添加：

node_modules/ .DS_Store

但不要盲目忽略wayfinder/state/，除非你明确知道自己在做什么。

5.3 结合项目需求微调 plan

实际情况下，AI 拆解的计划不一定完全符合你的期望。wayfinder skill 的设计允许你随时修改plan.md。

当你修改计划时，有两个选择：

• 直接把新计划覆盖到plan.md，然后告诉 AI“计划已更新，请按新计划继续”；
• 把修改记录下来，在decisions.md中追加一条决策。

第二种方式更推荐，尤其是当你改变了任务优先级、增加或删除了里程碑时。这些调整的原因如果写下来，未来的你和 AI 都能理解为什么计划会变成现在这样。

6. 常见问题与排查思路

wayfinder skill 的使用过程中，有些问题比较典型。下面整理了一张排查表。

6.1 关于“AI 不认 skill”的深入排查

最常被忽略的是文件路径。注意，.claude是隐藏目录，在 macOS 和 Linux 下默认不显示。如果你使用图形化文件管理器，需要按键显示隐藏文件才能看到。

另外，SKILL.md的 frontmatter 格式必须正确。frontmatter 是位于文件最顶部的---包裹的元信息区域，里面的name和description字段是 AI 识别 skill 的依据。如果---缺失或格式错误，AI 可能把整个文件当作普通 Markdown 读取。

最直接的验证方式是在对话中问 AI：

你当前知道了哪些可用技能？它们的名称和功能是什么？

如果 AI 列出了 wayfinder，说明它已经被加载。如果没有，优先检查路径和格式。

6.2 关于“上下文还是不够”的处理

有同学可能会问：跨会话规划能解决上下文不足的问题吗？

答案是部分解决。wayfinder skill 解决的是“项目级上下文”的持久化问题，而不是“单次任务上下文”的膨胀问题。

如果某个任务本身太大，即使有规划文件，AI 在单个会话中依然可能因为要处理的代码太多而丢失细节。这时需要进一步拆分任务，或者把大文件拆成多个小文件，让 AI 在单次会话中只聚焦一块内容。

这也解释了为什么 wayfinder skill 要求任务粒度适中。任务太长，单会话做不完；任务太短，管理成本又过高。找到一个合适的粒度，是使用这个技能最重要的调优工作。

7. 最佳实践与工程建议

7.1 把 goal.md 当作文档锚点

项目进行到一半时，最常见的问题是“AI 已经不知道当初为什么要做这个项目”。目标文件就是为了解决这个问题。

建议goal.md的内容包含几个要素：

• 一句话目标；
• 明确的技术栈；
• 可交付的成果；
• 明确不做什么（这是很多人忽略的）。

例如：

# 项目目标 为一款待办事项 Web 应用编写完整的后端 API，包含用户注册、登录、任务增删改查，并输出 API 文档。 技术栈：Node.js + Express + SQLite 交付物：可运行的 API 项目 + README 文档 + 基础测试 不包含：前端页面开发、第三方登录、部署上线

“不包含”这部分很重要。AI 经常会自主发挥，做一些超出需求范围的事情。“不包含”是一个边界，能有效防止范围蔓延。

7.2 进度文件保持简单

progress.md不需要写长篇大论。它的核心价值就在于一眼看清“现在到哪了”。建议保持以下几个区域不变：

• 当前状态；
• 任务状态；
• 阻塞与风险；
• 下一步。

其中“阻塞与风险”这个区域要主动维护。AI 在执行任务时如果遇到无法解决的问题，应该让它记录在这里，而不是自己硬猜一个方案。这样你下次打开项目时，能第一时间看到卡点在哪里。

7.3 决策日志是团队协作的粘合剂

如果你是单人使用 wayfinder，决策日志的价值可能不如团队场景明显。但如果你和同事共享同一个项目仓库，决策日志就变得非常重要。

比如，为什么这个任务用 JWT 而不是 session？为什么优先做认证而不是任务模块？这些决定如果不记录，新加入的同事就得重新问一遍，甚至可能推翻之前的方案。

建议决策日志使用简单的表格：

| 日期 | 决策 | 原因 | | --- | --- | --- | | 2025-06-01 | 使用 JWT 做认证 | 前端是纯静态页面，无 session 服务端 | | 2025-06-02 | 先实现认证模块 | 任务接口都依赖用户身份 |

7.4 注意安全边界

使用 wayfinder skill 规划项目时，AI 可能会在执行中提出一些高风险操作，比如批量删除数据、修改生产配置、执行数据库迁移等。在项目规划阶段就要明确：需要你确认后，AI 才能执行高风险动作。

你可以在SKILL.md中增加一条规则：

- 涉及删除、清空、覆盖大量数据的操作，必须先向用户确认并获得明确授权。 - 涉及生产环境的操作，默认禁止执行，除非用户明确给出足够的说明。

这既是保护项目，也是培养 AI 使用的好习惯。特别是在团队项目里，未授权的破坏性操作可能带来连锁影响。

7.5 不要过度依赖 skill

最后一条建议可能听起来有点反直觉：不要把一切任务都交给 wayfinder。

如果任务只需要一次对话就能完成，完全可以不用 skill。使用规划反而增加了额外的文件写入和读取成本，是一种“杀鸡用牛刀”。

更好的做法是，在SKILL.md的description中写清楚触发条件，让 AI 判断什么场景需要、什么场景不需要。比如：

description: 用于跨会话规划和管理任意规模的工作。当任务涉及多个步骤、可能持续多个会话，或需要长期跟踪时使用。

这样 AI 会在合适的场景自动选择使用 wayfinder，而不是每次对话都机械地加载它。

8. 总结与学习路线

wayfinder skill 的本质，是把“目标—计划—进度—决策”这套项目管理的基本功，用文件的形式固化下来，让 AI 在跨会话、跨任务时依然保持清晰的路线感。它不依赖某个神秘的模型能力，也不需要复杂的代码，核心就是四个 Markdown 文件加一份行为约束。

如果你从零开始实践，建议按这条路线推进：

第一步，先手动创建一个项目，把goal.md、plan.md、progress.md、decisions.md四个文件建好，不急着写SKILL.md。自己手动维护几次，体会一下“状态外置”的感觉。

第二步，再把SKILL.md加进去，让 AI 自动维护这些文件。注意观察 AI 是否会主动更新进度，如果不会，就在SKILL.md中加强约束。

第三步，用真实的中型项目去验证。至少找一个需要多个会话才能完成的任务，坚持用 wayfinder 跑完，感受和之前“每次新会话都重新讲解背景”的差异。

第四步，根据你的使用习惯调整模板。你可以增加风险登记表、工时估算、验收标准等字段，把 wayfinder 慢慢变成你自己的项目管理助手。

跨会话工作流是一个值得长期实践的方向。下一次当你面对一个复杂任务，与其在同一个会话里反复拉扯，不如先建一个 wayfinder 状态目录，把目标写进去，然后一点一点推进。希望这套思路能帮你把 AI 从“单次对话的工具”升级成“长期协作的搭档”。