<!-- title: 值守件首拆：夜班靠文件还是记忆 -->

## 概述

Skills 生态拆解第 5 轮，主题是工作流自动化：部署、CI、监控、多Agent协作。这个赛道本栏目其实已经打了三场：6 月底横评过「交付管线七引擎」，9 月初拆过「组织型 Skill 四强」，上期又刚过完部署四件。但翻回历期评测表会发现一个空位——**值守层**（长任务托管、跨会话交接、定时唤醒）里的大多数件，从来只当过表格里的一行分数，没被单独拆开看过正文。本期补课：long-running-agent、planning-with-files、remembering-conversations、宿主原生 loop 四件值守件横评，外加一条跑了三个多月、按日归档产稿的真实自动化管线当解剖台。核心发现：管线成熟后都会手搓出 planning-with-files 的架构，值守件的真正卖点，是把交接班制度从手搓变成标准件。

## 评测对比表

评分沿用本系列五维权重（功能 25%、设计 25%、实战 20%、上手 15%、社区 15%），并继承前评底稿中可考的分数与事实；证据不足处标「推断」。

| Skill | 功能完整度 | 设计质量 | 实战效果 | 上手难度 | 社区活跃度 | 加权分 |
|---|---|---|---|---|---|---|
| planning-with-files | ★★★★★ | ★★★★ | ★★★★ | ★★★★★ | ★★★★★ | 4.55 |
| loop（宿主原生对照） | ★★★★ | ★★★★★ | ★★★★ | ★★★★★ | ★★★ | 4.25 |
| remembering-conversations | ★★★★ | ★★★★ | ★★★ | ★★★★ | ★★★ | 3.65 |
| long-running-agent | ★★★（推断） | ★★★★ | ★★★（推断） | ★★★ | ★★★ | 3.25 |

---

## planning-with-files：值守层的地基，本期主拆

**定位**：来自 [OthmanAdi/planning-with-files](https://github.com/OthmanAdi/planning-with-files)。本栏目 5 月盘点时它 17,700+ 星，是当时 GitHub 上单 Skill 星数最高的一件；兼容 Claude Code、Cursor、Gemini CLI、Codex CLI 等 40+ 个 Agent 平台。四个多月过去，星数大概率仍在涨，以仓库实时数据为准。

它做的事一句话能说完：**把文件系统当磁盘，把上下文窗口当 RAM**。自动维护三份 Markdown 工作记忆文件——`task_plan.md`（计划）、`findings.md`（发现）、`progress.md`（进度），会话断了，状态在盘上。

**设计拆解**。为什么是三份而不是一份？因为它们对应交接班制度里的三种文书：`task_plan.md` 是班表，写的是「这一班要干什么、干到哪一步算完」；`findings.md` 是交接留言，写的是「这班踩过的坑、查到的结论」；`progress.md` 是打卡记录，写的是「每一步做没做完」。夜班工人换了三拨，只要这三份文件在，第四拨进门五分钟就能开工。

为什么是 Markdown 而不是 JSON？三个理由：人眼可读，你不需要工具就能抽查 Agent 干到哪了；diff 可审，每次改写都在版本控制里留下痕迹，出了问题能回放；读取零门槛，任何一个新 Agent 不需要装解析器就能接着干。这也是它敢兼容 40+ 平台的底气——不依赖任何一家的私有机制，只赌「文件永远在」这个最朴素的假设。

**短板**也在这套设计里。其一，计划会腐烂：`task_plan.md` 写完第一天是制度，第三周可能就是考古现场，skill 本身没有强制的回收机制，靠宿主自觉更新。其二，文件漂移：多个 Agent 同时写一份 `progress.md` 时没有加锁语义，并发场景要靠使用者自己定纪律。其三，它只管「记」，不管「验」——文件写错了下一步就跟着错，交接物没有校对环节。9 月那期组织型 Skill 横评提炼的命题二「通信靠文件不靠玄学」，血统正是源自它；但那个命题也留了半句话没说完：文件即邮件，可邮件也会送错。

## long-running-agent：夜班工人，证据密度最低的一件

**定位**：本机装机清单在册，是让单个 Agent 把活干过夜的托管件——长任务中途存档、断了续跑、控制节奏。方法论根基可以追溯到 Anthropic 官方工程文《Effective Harnesses for Long-Running Agents》：长任务的核心矛盾是上下文会满、会话会断，宿主必须自带「检查点-恢复」的骨架。

**声明证据密度**：这是四件中唯一从未被本栏目单独拆过文的。装机在册、前评底稿给过 3.80 的综合分，但其仓库文档的可考度有限，本文功能与实战两维按设计意图评，标「推断」。

**亮点**：它补的是值守链上最脏的一段——四小时的任务跑挂在三小时五十分，前面全白干。检查点续跑解决的正是这个。短板同样结构化：断点语义和宿主版本强耦合，宿主一升级，恢复逻辑可能整段作废；而且「续跑」续的只是任务状态，上下文里的隐性知识（试错手感）续不回来——这部分恰恰要靠文件派或记忆派来补。所以它注定不是单件，是组合件。

## remembering-conversations：记忆派的对照样本

**定位**：跨会话的长期记忆件。本栏目 6 月横评底稿里给它和它的邻居分过工：`remembering-conversations` 记**事实**，`continuous-learning-v2` 记**行为模式与策略**——前者是笔记本，后者是复盘会。

把它拉进本期，是因为它和 planning-with-files 构成值守层的两派：**文件派 vs 记忆派**。文件派的状态在盘上，可读、可 diff、可抽查；记忆派的状态在会话沉淀里，优点是省事、不占工作目录，缺点是交接时不可抽查——下一班只能「信」上一班的回忆，没法像打开 `findings.md` 那样逐条核对。值班场景里这是致命的：交接班最怕的不是没记录，是记录没法验。所以本期的结论是：值守链用文件派打底，记忆派做补充——事实落盘，手感留忆。

## loop：宿主自带的钟，一分钱不花

**定位**：不是市场件，是 Claude Code 宿主原生能力。行为可直接引用宿主文档语义：`/loop 5m /foo` 每 5 分钟跑一次指定任务，不指定间隔默认 10 分钟；底层是本地时区的标准五字段 cron；只在 REPL 空闲时触发，不打断手头的活；默认会话级（进程退了就没了），加 durable 参数才落盘到 `.claude/scheduled_tasks.json`，且循环任务 7 天后自动过期。

**设计质量是四件中最高的**。它把「值守」拆成了两个问题：什么时候叫（loop 管），叫醒之后怎么干（市场件管）。市场件的文档经常把这两件事搅在一起吹，而原生件诚实地只做钟。7 天自动过期这条尤其值得抄——所有定时任务都该有默认寿命，否则 cron 表只会越积越脏。

---

## 解剖台：一条真跑着的管线怎么排班

光评件不看线是纸上谈兵。本期解剖台是本仓库自己：一套按日归档产出的内容流水线，`output/` 下从 5 月排到 9 月的日期目录、`sync-staging/` 里逐月叠放的底稿，就是它跑了三个多月的考勤。

读它的两个脚本很有启发。`generate_daily.sh` 干的事：拼一份含「今日产出、日志摘要、任务状态」的中文提示词，管道喂给 headless 的 Claude 命令行，600 秒超时，产出日报后自动调 `publish.sh` 发布——注意它的提示词里固定包含「去重检查」和「明日计划」两节，**交接班文书是写进流水线骨架的，不是靠 Agent 自觉**。`token_checker.sh` 干的事：先发一句「回复OK」探针，输出里 grep 到 429、rate limit、quota 就报限流，还顺手解析恢复时间——一个手搓的额度断路器，夜班自动化最先撞死的墙就是额度墙，它先用一个 shell 函数把墙变成了红绿灯。

最有意思的发现在这：这套管线的状态存在 `STATE_FILE`、交接存在日报、按日归档、断路器前置——**它手搓出了一个 planning-with-files**。这印证了本期的核心判断：文件派架构不是某个作者的聪明，是无人值守自动化的收敛解；skill 的真正价值，是把每个团队都要重踩一遍的手搓过程，变成装上就有的标准件。

白班件本期不重评，只报位置：6 月底稿的结论今天依然成立——部署引擎已经商品化，差异化和利润集中在 CI 自愈与运行时监控两端，而定时唤醒是把它们黏成闭环的粘合剂。白班的规矩（CI 宪法）、白班的兜底（监控），前评已拆，本期值守四件接的就是它们的夜班。

## 值守闭环全景

```mermaid
flowchart TD
    A["cron 钟响<br/>或 /loop 触发"] --> B["token_checker<br/>额度断路器"]
    B -->|额度可用| C["值守件接手<br/>long-running-agent"]
    B -->|限流退避| A
    C --> D["读三件交接文件<br/>planning-with-files"]
    D --> E["按 task_plan 续跑"]
    E --> F{"任务跑完了吗"}
    F -->|没跑完| G["写回 progress<br/>存好 findings"]
    G --> C
    F -->|跑完了| H["回写结论<br/>remembering-conversations"]
    H --> I["生成日报<br/>generate_daily"]
    I --> J["publish 发布<br/>等下一班"]
```

文件派与记忆派的分歧，一张图看清：

```mermaid
flowchart TD
    subgraph L1["文件派：状态在盘上"]
        P1["task_plan.md 班表"] --> P2["findings.md 交接留言"]
        P2 --> P3["progress.md 打卡"]
    end
    subgraph L2["记忆派：状态在会话"]
        M1["当班对话"] --> M2["沉淀回忆"]
        M2 --> M3["下一班召回"]
    end
    P3 --> X["共同短板：谁校对交接物"]
    M3 --> X
```

## 分维度排行榜

- **功能完整度**：planning-with-files ＞ loop ＝ remembering-conversations ＞ long-running-agent
- **设计质量**：loop ＞ planning-with-files ＝ remembering-conversations ＝ long-running-agent
- **实战效果**：planning-with-files ＝ loop ＞ remembering-conversations ＝ long-running-agent（后两件佐证以社区反馈与前评底稿为主，推断成分已标）
- **上手难度（从易到难）**：planning-with-files ＝ loop ＞ remembering-conversations ＞ long-running-agent
- **社区活跃度**：planning-with-files 一骑绝尘，其余三件持平（loop 属宿主原生，无社区概念，按可查资料计）

**装机优先级**：先装 planning-with-files——它是值守层的地基，也是全生态性价比最高的一件；再学会免费用 loop 排班；记忆派与长任务托管件按需加配，别一上来全装，值守层的每一件都要交上下文税。

## 安装 / 使用命令

```bash
# planning-with-files（仓库地址已核实）
git clone https://github.com/OthmanAdi/planning-with-files ~/.claude/skills/planning-with-files
# 或用 skills CLI
npx skills add OthmanAdi/planning-with-files

# long-running-agent / remembering-conversations
# 本机装机清单已在册；外部安装请先检索再装，本文不附未核实的仓库链接
npx skills find long-running-agent
npx skills find remembering-conversations
# 检索到目标后：npx skills add <owner>/<repo>

# loop：宿主原生，无需安装
# 会话内直接：/loop 5m /你的任务命令
```

## 参考来源

1. [OthmanAdi/planning-with-files](https://github.com/OthmanAdi/planning-with-files) — 本期主拆对象仓库；17.7K+ 星与三文件架构描述引自本栏目 2026-05-16 盘点底稿
2. [Anthropic: Effective Harnesses for Long-Running Agents](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents) — 长任务 Agent「检查点-恢复」方法论根基
3. [Cursor Blog: Long-Running Agents](https://cursor.com/blog/long-running-agents) — 长任务 Agent 的工程实践参照
4. [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) — Skills 生态清单仓库，本期值守件检索入口之一
5. [Claude Code GitHub Actions 官方文档](https://code.claude.com/docs/en/github-actions) — 白班 CI 集成的官方参照，前评 github-actions-skill 的对照基准

> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)
