claude-code-waypoint

为Claude Code项目提供持久化记忆和上下文管理的战略检查点工具。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:claude-code-waypoint。
它的用途是:为Claude Code项目提供持久化记忆和上下文管理的战略检查点工具。
完整的 Skill 内容见:https://321skill.com/skills/claude-code-waypoint/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

`/plan 为电商平台构建用户积分系统`,它会引导你讨论需求和技术选型。讨论成熟后,再说:`/create-plan points-system`,它会生成详细的计划文档。之后,你可以随时通过 `/resume points-system` 快速回到这个任务,继续开发或审查进度。

介绍

Claude Code Waypoint 解决了在复杂AI协作项目中,因上下文重置、会话中断而导致的进度丢失、决策遗忘和重复沟通问题。它通过在项目中创建战略检查点(Waypoint),将规划、决策和当前状态持久化到文件中,确保每次中断后都能在60秒内恢复工作。

使用时,开发者首先通过 /plan 命令与Claude进行探索性讨论,明确需求后,使用 /create-plan 命令将讨论结果正式化为一个包含计划、上下文和任务清单的三文件结构。在实施过程中,通过 /update-context 更新状态,并通过 /resume 命令快速恢复。

该工具非常适合需要与AI进行长期、复杂项目协作的开发者,尤其是那些项目周期长、技术决策多、容易被打断的工作流。无论是开发新功能、重构代码还是进行技术调研,都能从中受益。

建议用户将创建和审核Waypoint视为正式的项目里程碑。在批准计划前,务必亲自审查生成的文件,确保其符合项目目标。同时,养成在重要节点手动更新上下文的习惯,以最大化工具的效用。

核心特点

与单纯记录对话历史的工具不同,它强制将非结构化的讨论转化为结构化的计划、上下文和任务三件套,形成可执行、可追溯的项目档案。其核心在于“规划先行”的工作流,引导用户在动手前先完成思考和决策记录。

注意事项

不适合用于极其简单、一次性或无需保留上下文的临时性任务。

常见问题

Waypoint文件是自动生成的吗?

是的,通过 `/create-plan` 命令,Claude会根据之前的讨论自动生成计划、上下文和任务文件。

如何恢复一个之前创建的Waypoint?

使用 `/resume` 命令加上Waypoint名称(例如 `/resume auth-system`),即可快速加载该Waypoint的全部上下文。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/claude-code-waypoint/raw/index.md 读取 claude-code-waypoint 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。