网页端和手机端没有文件系统？one-skill-to-rule-them-all 交接文档模式（Handoff Doc）完整指南
【免费下载链接】one-skill-to-rule-them-allThe meta-skill that builds and improves all your skills, including itself. Watches your work sessions (autonomous or human-led), captures patterns, corrections and judgement calls, and turns them into skill improvements and new skill candidates for your review. Practical application of the Augmented Expertise methodology. Open source: CC BY 4.0.项目地址: https://gitcode.com/gh_mirrors/on/one-skill-to-rule-them-all
在网页端或手机上使用one-skill-to-rule-them-all（task-observer 元技能）时，没有文件系统可以写入观察日志？别担心，交接文档模式（Handoff Doc）就是为这类环境设计的：AI 会话中收集的技能观察不会丢失，而是打包成一份结构化交接文档，你在下一个有文件系统的会话中粘贴进去即可落地存档。
一、为什么需要"交接文档"？先搞懂三种存储环境
task-observer 的核心机制是"观察—记录—改进"：它在你的工作会话中捕捉模式、纠正和判断决策，把它们写进观察日志（skill-observations/observation-log/），再转化为技能改进建议。
但"写日志"需要一个持久化存储。项目把环境按持久能力分成三种存储模式（见 references/environments.md 的 Storage regimes 一节）：
| 环境 | 持久工作区 | 观察记录方式 |
|---|---|---|
| Claude Cowork | 共享文件夹 | 直接写入文件系统（完整体验） |
| Claude Code | 固定绝对路径 | 直接写入文件系统（完整体验） |
| 网页端 / 手机聊天 | ❌ 无 | ✨ 交接文档模式（Handoff Doc） |
也就是说：Claude.ai 网页版和手机 App 里，技能照样在后台观察你的工作，但无法把观察写成日志文件。此时它切换为交接文档模式——这也是作者本人最初开发该技能时使用的模式。
二、交接文档模式的工作原理：3 步完成跨设备协作
整个流程非常简单，你可以理解为"移动端收集 → 文档中转 → 桌面端落地"：
- 会话中收集：你在网页端或手机上正常使用技能，观察者全程记录模式、纠正与方法论信号（这些规则的完整目录见 references/signals.md）。
- 会话末尾交付：当对话临近结束时，技能会主动提议生成一份结构化交接文档（你也可以直接索要）。官方文档特意强调：早提议只是小打扰，忘了提议才是真正的工作丢失。
- 粘贴到下一会话：你把交接文档带到下一个会话——最好是有文件系统的 Cowork 任务或 Code 会话——观察者会把其中每条观察写成独立的日志文件，正式进入观察日志队列。
💡 官方用户指南（USER-GUIDE.md）明确建议：在聊天类环境结束时索取交接文档，然后把它交给下一个会话，甚至更好的做法是交给 Cowork 任务处理——这正是"网页端/手机端没有文件系统"场景下的标准工作流。
三、交接文档长什么样？6 个固定区块
交接文档采用固定的 Markdown 模板（模板定义见 references/environments.md 的 Handoff-doc mode 一节），包含 6 个区块：
- Session Handoff 标题 + 日期：会话主题与日期
- Context（上下文）：本次做了什么、下一个会话需要知道什么
- Decisions Made（已做决策）：编号列出
- Observations Logged（已记录观察）：按 SKILL.md 中"如何记录"的 frontmatter 格式逐条给出，下一个会话会为每条写一个独立的日志文件
- Cross-Cutting Principles（横切原则）：当前生效或新增的跨技能通用原则
- Action Items + Working Artifacts（行动项与工作产物）：带足够上下文、可恢复工作的下一步，以及草稿/分析等完整内容
这份结构保证了交接信息自包含：下一会话不需要回忆任何细节，读文档就能接手。
四、接收端如何"消化"交接文档？4 步分析流程
交接文档不只是搬运——接收会话会做一轮分析（见 references/environments.md 的 Handoff-doc analysis 一节）：
- 先记录所有明示观察：不加过滤，逐条落盘；
- 系统性地通读每个区块，挖掘"被暗示但未明说"的技能缺口与新技能候选——交接文档携带的信号往往超出当场捕获的内容；
- 重点关注：行动项（每项可能暗示一个缺失技能）、开放问题（歧义意味着决策框架缺口）、已完成工作叙述（可能暴露元技能模式）；
- 正确归因：从分析中衍生出的观察要标注来源是"交接文档分析"，而非原始会话。
五、实用技巧：让交接文档不丢信息
- 结束会话前问一句"记录了哪些观察？"：作者本人的习惯是每次归档任务都问一遍，这是捕获率最高的做法（详见 USER-GUIDE.md 的 Checking in on observations 一节）。
- 依赖会话内数据时要持久化：若某条观察依赖本次会话的临时数据（上传文件、接口输出等），应先把证据存入工作区，并用
reference:字段指向持久路径——这个指针必须能活过会话和重启，references/observation-log.md 中专门有"Context preservation"规则约束这一点。 - 多会话分工要带"所有权围栏"：当交接文档把观察日志的待办拆给多个并行会话时，需要给出明确的范围内 id 列表、范围外列表，并约定各会话只改自己负责的条目（见 references/observation-log.md 的 Editing an existing observation 一节）。
- 验证技能是否激活：如果几次真实工作后
skill-observations/observation-log/目录不存在，说明激活从未发生，需检查激活配置（SKILL.md 的 Session Start Protocol 与 references/environments.md 有完整诊断路径）。
六、总结：一张表看懂各环境体验
| 能力 | Cowork / 桌面 Code | 网页端 / 手机端 |
|---|---|---|
| 后台观察记录 | ✅ | ✅ |
| 写入文件系统日志 | ✅ 直接写入 | ❌ 用交接文档替代 |
| 技能更新暂存与安装 | ✅skill-updates/目录 | 通过交接文档转交 |
| 定期评审 | 可配置定时任务 | 日历提醒 + 手动触发 |
| 会话开始钩子 | Code 支持 SessionStart 钩子 | 无 |
一句话总结：网页端和手机端不是降级，而是换了一条更轻量的数据通道。交接文档模式让 one-skill-to-rule-them-all 的技能观察循环真正做到了环境无关——你用手机聊出的每一个纠正和灵感，都能安全流回你的技能库。
📁延伸阅读（项目内文件）：
- 核心技能定义：SKILL.md
- 环境与交接文档模式细节：references/environments.md
- 观察日志格式与规则：references/observation-log.md
- 值得记录什么、什么不值得：references/signals.md
- 定期评审流程：references/weekly-review.md
- 用户上手指南：USER-GUIDE.md
【免费下载链接】one-skill-to-rule-them-allThe meta-skill that builds and improves all your skills, including itself. Watches your work sessions (autonomous or human-led), captures patterns, corrections and judgement calls, and turns them into skill improvements and new skill candidates for your review. Practical application of the Augmented Expertise methodology. Open source: CC BY 4.0.项目地址: https://gitcode.com/gh_mirrors/on/one-skill-to-rule-them-all
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
