Flightwake – AI编程代理的飞行记录器，而非导航仪

Flightwake 是一个超轻量级的工作记录框架，专为强大的 AI 编程代理（如 Claude Code、Codex 和 Gemini）设计。它的核心理念是：记录跟随工作，而非引领工作。与需要逐步导航的工具不同，Flightwake 就像行车记录仪加警示灯和路标——强模型自己驾驶，框架只负责记录和纪律约束。

安装只需在项目根目录运行 npx flightwake init，它会创建 .flightwake/ 目录（包含模板和钩子），复制四个技能到 .claude/skills/，并修改代理指令文件（如 CLAUDE.md）。整个过程零运行时依赖，纯 Markdown 格式，所有数据都存在于 git 中。

使用方式很简单：每个会话开始前输入 /fw-coldstart，模型会自动读取最新状态记录；进行重要决策时手动记录到 DECISIONS.md（一行带原因）；遇到陷阱时使用 /fw-trap；会话结束时运行 /fw-record 生成飞行记录并更新状态。若会话要跨session，使用 /fw-handoff 生成上下文。忘记记录时，Stop 钩子会在提交落后三个提交时发出提醒。

Flightwake 解决了四个模型自身无法克服的结构性问题：会话死亡导致记忆清零；git 只记录变更不记录原因；长会话中纪律松懈；不同代理和人类之间状态不共享。通过记录决策、陷阱和验证证据，Flightwake 提供了持久性和纪律保证，而非智能辅助。

该项目自身也使用了 Flightwake 进行开发，.flightwake/ 目录中真实记录了从开发到开源的全过程。它兼容现有的 GSD（Go, go, go, Stop）工具，可共存并迁移。V0.9 版本将提供英文默认配置，目前安装模板和技能默认为繁体中文。

此外，Flightwake 还提供了高级安装选项，如 --private 模式可将记录保存在本地而不提交到 git，适合在他人仓库中个人使用。卸载命令可以干净地移除框架文件而不影响用户数据。对于大型单仓库，建议在根目录安装一次，避免子目录安装导致记录碎片化。从 GSD 迁移也很简单，只需初始化后告知代理读取旧规划并初始化状态即可。

Flightwake 还包含可选的 --statusline 功能，在 Claude Code 底部显示持久的状态条，包括健康颜色、STATE 滞后程度和上下文使用率。CI 集成也可通过钩子脚本实现，确保其他代理和人类协作时也遵守同样的纪律。

总之，Flightwake 是一个轻量且实用的框架，专为日益强大的 AI 编程代理设计，帮助团队在多个会话和代理之间保持工作连续性和质量。