zfl-task-summary — 任务摘要规范
> 每次任务结束后，在回复末尾追加 [任务摘要] 段落，便于下次会话接续。
用途
- 自动在回复末尾追加结构化任务摘要（做了什么 / 产出物 / 下一步 / 提炼项），让下次会话直接接续
- 内置校验：格式合规自检 + 反模式规避，错则 AI 自动修复（AI 自愈，输出可直接确认的修正草案，无需人工重排）
- 跨技能生效：任何技能执行完都追摘要；多技能同触发时自动合并去重
> 完整格式模板、填写规范、校验规则、反模式、FAQ、跨技能协调细则见 references/implementation-details.md。
触发判定（命中即触发）
| 触发（满足任一条必须追加） | 豁免（无需追加） |
|---|---|
| ①有文件写/改 ②工具调用≥2次且产出 ③生成可交付物 ④多步任务最后一步 ⑤用户明确要求 | 纯问候 / 纯查询 / 单轮问答 / 过渡回复 |
> 触发模型澄清（防误判）：本技能是【自动行为触发】，依据上方 ①②③④ 等客观行为条件判定，
> 不要求用户说出"总结/摘要/帮我记一下"等关键词。常见的误判是系统等待用户显式要求才加载本技能——
> 这是错的。只要任务满足"实质产出"条件（写/改了文件、跑了多次工具产生结果、交付了产物、跨多步收尾），
> 即便用户全程没提"摘要"二字，也必须在回复末尾追加。用户说"别写摘要"才是唯一退出信号。
与其他技能的关系
- 联动：所有技能执行完毕后追加摘要（zfl-skill-creator 创建、zfl-skill-syncer 同步后均追加）
- 互补：zfl-memory-curator 负责记忆分层治理，本技能负责单次会话收尾摘要
- 下游：摘要中的"提炼项"可触发 zfl-skill-creator 创建新技能
联动 OPEN 台账（跨会话连续性，写端，v1.2.3 新增）
与 zfl-memory-curator 的"读 + 回显 + 关闭"端互补：本技能负责写端——任务收尾时把跨会话状态写入 <workspace>/.workbuddy/memory/MEMORY.md 的 OPEN/RESOLVED 台账（单一真相源，不重复定义格式）。
何时写
- 本次任务浮现新的持久决策/待办（用户拍板 / 待校准 / 待样本）→ 追加为 OPEN 项（编号续 O 序列、标紧急度、必要时"逢会触发"）。
- 本次任务解决了某个 OPEN 项 → 在
[任务摘要]的"下一步/提炼项"同步标注"已关闭 X→RESOLVED"，由 memory-curator 下轮开场正式回显关闭。 - 纯问候 / 单轮查询豁免（无跨会话状态变化）。
纪律
- 只追加 / 关闭，不重写台账格式（格式归 memory-curator 定义）。
- "下一步"字段若含需跨会话跟进的事项，必须同时落 OPEN 台账，避免只活在摘要里被下轮忽略。
会话归档（条件式必做，调用 zfl-common 标准件，v1.2.5 新增）
> 触发条件：本次会话在共享工作台（如 _workbench/）产生 ≥3 个 scratch 文件（脚本/日志/数据/中间产物），或用户明确要求「归档 / 整理 / 收尾」。不满足则不触发（不给轻量任务强加归档）。
> 依据 SSOT：zfl-common/references/archive-safety-discipline.md（零删除归档四要素）。
满足条件时，本环节是"必做"，不是"可选建议" —— 缺任一段即视为收尾未完成。
- 前置探测：先判
zfl-common是否在位（<skills>/zfl-common/scripts/session_archive.py存在且 VERSION ≥ 1.32.0）。不在位 → 在摘要「下一步」注明「会话归档未做：zfl-common 缺失」，不静默跳过。 - 执行（可直接复制）：写
plan.json（archive_dir+root+items[{src,dst,mode}]），先 dry-run 再--apply：
bash python <zfl-common>/scripts/session_archive.py --plan plan.json # dry-run，先看计划 python <zfl-common>/scripts/session_archive.py --plan plan.json --apply \ --exclude "<并发写方glob>" --manifest <项目归档区>/_move_manifest_$(date +%Y%m%d).csv - 产出并入：标准件输出的「src→dst」逐条结果 → 落成归档区
README.md的对照表（归档位置 | 内容 | 原位）；manifest 追加行 → 项目归档台账。二者写入摘要「产出物」。
降级纪律：无 zfl-common / 标准件缺失时，仅执行底线两条（移动而非删除 + 留对照表可回滚），并在摘要显式标注「未走标准件（降级）」；任何情况下禁用 rm 收尾。
@see zfl-common/references/archive-safety-discipline.md
@see zfl-common/scripts/session_archive.py
自测
- 合规判定：回复末尾含
---+[任务摘要]+ 四字段（做了什么/产出物/下一步/提炼项） - 完整自检清单与校验检查点见
references/implementation-details.md - 自动校验脚本见
references/auto-verify.md
常见踩坑速览（FAQ）
Q1：一次做了多件事，怎么写？ 合并为一份摘要，不重复追加：用分号并列核心目标；"产出物"逐行列出所有文件；"下一步"合并去重后标优先级。
Q2：多个技能同时触发，会重复追加吗？ 不会。只输出一份，按最高价值产出合并，主技能优先（详见跨技能协调规则）。
Q3：摘要太长怎么办？ 套用「摘要瘦身原则」：只留目标/约束/产出物/下一步，丢弃过程、临时路径、冗余背景。
Q4：纯聊天 / 纯问答要写吗？ 不写。纯问候、纯查询、单轮问答、过渡回复均豁免。
Q5：校验不通过会怎样？ AI 直接产出「定位 + 原因 + 自动修复草案」三段式修正，你确认后即可，无需手动重排。
Q6：提炼项没东西可写怎么办？ 直接写"无"，不要留空，也不要硬凑。
> 完整反模式对照表（❌→✅）与 5 条提炼识别标准见 references/implementation-details.md。
首次运行初始化（自检 → 沉淀全局记忆）
本技能首次被使用时，执行一次自检：读取 ~/.workbuddy/MEMORY.md，若其中不含"任务收尾带 [任务摘要]"相关规则，则用 Edit 工具在其末尾追加一行索引（示例：- 任务收尾规范：实质任务回复末尾追加 [任务摘要]（四字段：做了什么/产出物/下一步/提炼项），详见 zfl-task-summary 技能），使该规范沉淀为用户全局习惯，后续所有会话自动生效。
- 仅首次（或记忆中缺失时）写入，避免重复追加；已存在等价规则则跳过。
- 写入位置是用户记忆层（存偏好之处），不改动 SOUL.md / settings.json 等身份或全局配置。
- 本段逻辑随技能包分发，他人安装并首次运行后自愈，无需手动配置。
示例（追加格式）
实质任务收尾后，回复末尾自动追加四字段摘要；纯问候 / 纯查询 / 单轮问答 / 过渡回复豁免。
模板（四字段，缺一即校验失败）：
[任务摘要]
- 做了什么：...
- 产出物：...
- 下一步：...
- 提炼项：...
真实样例（一次修复脚本 bug 后的收尾，注意"提炼项"落了可复用经验并触发 creator）：
[任务摘要]
- 做了什么：修复 zfl-skill-catalog 的 check_updates.py 在 skills_data.json 损坏时静默覆盖、丢失全部 MD5 基线的问题，改为拒绝写回并输出明确 ERROR；复评 P0/P1 清零后升 1.0.7 发布。
- 产出物：zfl-skill-catalog 1.0.7（SKILL.md / references/FAQ.md / scripts/check_updates.py / CHANGELOG+VERSION）。
- 下一步：① 等待 13:04 匿名复验确认传播；② 下周清理 scripts 死代码（P2 项）。
- 提炼项：JSON 解析失败必须显式报错而非空 catch 静默吞掉（已入 PF-675 同族）；文件损坏时"拒绝写回"比"覆盖重试"更安全。
> 输出自查：四字段齐全、产出物只列可交付绝对路径（不含 __pycache__/temp）、下一步写明动作+优先级、提炼项非空即写可复用经验。校验失败时的「表现→原因→修正」对照表见 references/auto-verify.md。
约束与错误处理
- 本技能仅处理其声明范围内的任务，不越界执行未授权操作。
- 错误处理：输入不合法时返回明确错误说明，不静默跳过；依赖缺失时降级提示并给出替代路径。
- 校验失败处理（AI 自愈可对照执行）：摘要未通过
references/auto-verify.md的 5 项检查时，按「定位问题 → 说明原因 → 产出修正草案」三段式立即修正，不发出未合规摘要。常见失败表现与对应修正动作（漏标题 / 缺"提炼项" / 产出物含临时路径 / 下一步笼统 / 多技能重复追加 / 误判触发）见references/auto-verify.md末尾对照表。修正后重新执行 5 项检查，全部通过才发出。 - 字段口径唯一真相源：全技能统一"四字段"（做了什么 / 产出物 / 下一步 / 提炼项）。
SKILL.md与references/auto-verify.md必须一致；若任一文档改字段数，另一份同步改，禁止出现"三字段"旧表述残留。
不适用场景
- 不适用于需要实时交互或外部 API 调用的场景。
- 不适用于超出本技能声明范围的任务类型。
自检与成功标准
- 成功标准：输出满足任务声明的全部要求，关键信息完整无遗漏，视为完成。
- 输出前自检：核对输出是否覆盖全部要求项、数据是否准确、格式是否符合规范。
