Task State Ledger：为长任务建立可移植的状态账本

技能简介

Task State Ledger 是一款面向长周期技术任务的 Agent 技能，用于解决一个非常现实的问题：跨会话、跨天数的复杂工作，很容易丢失关键决策、证据和下一步动作。当任务从"改一个文件"升级到"重构多个模块、跑通整条验证链"时，上下文一旦中断，人就只能凭记忆重建，而记忆不可靠。

这个技能的核心思路很朴素：把任务状态写进一个结构化的 Markdown 账本文件，把经过审阅的证据单独存放到本地证据目录，用稳定的节点标识符互相引用。状态保持精简，证据保持可追溯。它支持 Claude、Codex 与 Claude Code，属于"AI Agent"工作流类技能。

核心能力

1. 生成结构化状态账本：基于内置的 task-state 模板，创建格式统一的 Markdown 账本文件，字段固定、位置固定，方便人和 Agent 反复读取。
2. 记录任务全要素：完整记录目标、里程碑、已做决策、当前阻塞、下一步动作，以及"哪些部分尚未验证"的验证边界。
3. 本地证据落盘：把经过审阅的证据写入本地证据目录，使用稳定的节点标识符命名，确保引用不会因为会话重启而失效。
4. 写入前安全校验：拒绝不安全的节点标识符，并在写入前拦截多种常见密钥模式，避免把凭据写进证据文件。
5. 指导选择性检索：当任务恢复或需要交接时，指导 Agent 只读取与当前决策相关的证据，而不是把整份历史全部灌回上下文。
6. 支撑技术交接：把已完成工作、阻塞点、证据路径、责任人、安全边界整理成一份可直接交接的摘要。

安装配置

1. 安装技能：执行 npx skillstore add glenskii/task-state-ledger，把技能加入本地技能库。
2. 确认运行环境：准备支持技能的 Claude、Codex 或 Claude Code 客户端，并确保工作目录对项目文件具备读写权限。
3. 规划目录结构：约定好状态账本文件路径与本地证据目录路径，二者分离，账本保持精简、证据单独存放。
4. 校验版本：当前版本为 1.1.0，技能仓库 revision 为 r2，建议在安装后确认版本号为 1.1.0 以启用最新的标识符与密钥校验逻辑。

使用步骤

1. 初始化账本：用 $task-state-ledger 创建一个本地账本，先写清目标、项目边界、当前状态和证据限制。
2. 按里程碑更新：每当做出重要决策、遇到失败、或验证通过一个里程碑，就立刻更新账本，记录证据引用并注明哪些部分仍未验证。
3. 暂停前归档：在暂停多文件改动之前，把决策、受影响的文件、验证边界和下一步动作写入账本，保证下次能原地续接。
4. 恢复时按需取证：任务恢复时先读当前状态，确定下一个待决策点，然后只检索与该决策相关的证据。
5. 交接时输出摘要：整理已完成工作、阻塞点、责任人、证据路径、安全限制和一条明确的下一步动作，形成交接文档。

适用场景

• 恢复复杂变更：多文件重构进行到一半需要中断时，用账本保住决策链，避免下次只能从头猜。
• 准备技术交接：把工作进度、阻塞点、证据引用和剩余验证项一次性交代清楚，接手人不必反复追问。
• 追踪发布证据：把经过审阅的构建与测试结果与精简的发布状态分开保存，审计时随时可查。
• 长期研究任务：需要跨天甚至跨周推进的分析工作，靠账本维持决策的连续性。

适用人群

适合长期与 AI 编程 Agent 协作的开发者、需要频繁交接的技术负责人、以及任何要处理跨会话长任务的工程师。如果你的工作经常"做到一半被打断，回来不知道做到哪了"，这个技能正是为你准备的。

工作原理

技能通过模板生成一份结构化 Markdown 账本，把"状态"与"证据"分层：状态层只放精炼的结论与下一步动作，证据层存放经过审阅的细节文件。两层之间通过稳定的节点标识符建立引用关系。在写入任何证据之前，技能会先校验节点标识符的安全性，并扫描常见的密钥模式，从源头降低凭据泄漏风险。任务恢复时，技能引导 Agent 先读账本，再按当前决策点选择性取证，从而控制上下文占用。

注意事项

• 它无法恢复从未被记录过的信息，账本的价值取决于是否及时更新。
• 密钥检测覆盖常见模式，但不能替代人工审阅。
• 它不会修改应用的记忆机制，也不会自动加载历史会话。
• 本地证据仍受项目访问权限、隐私与留存策略约束；不要把凭据、客户数据、Cookie 或未审阅的环境输出写入证据目录。

官方链接

• Skill 详情页：https://skillstore.io/skills/glenskii-task-state-ledger
• 项目仓库：https://github.com/glenskii/glenski-toolkit