首页 › skills-review › 值守件首拆:夜班靠文件还是记忆

概述

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。本栏目 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 宪法)、白班的兜底(监控),前评已拆,本期值守四件接的就是它们的夜班。

值守闭环全景

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/>等下一班"]

文件派与记忆派的分歧,一张图看清:

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 排班;记忆派与长任务托管件按需加配,别一上来全装,值守层的每一件都要交上下文税。

安装 / 使用命令

# 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 — 本期主拆对象仓库;17.7K+ 星与三文件架构描述引自本栏目 2026-05-16 盘点底稿
  2. Anthropic: Effective Harnesses for Long-Running Agents — 长任务 Agent「检查点-恢复」方法论根基
  3. Cursor Blog: Long-Running Agents — 长任务 Agent 的工程实践参照
  4. ComposioHQ/awesome-claude-skills — Skills 生态清单仓库,本期值守件检索入口之一
  5. Claude Code 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学通信知识星球海报-扫码加入