pi-tasks
为AI Agent提供Pi原生的、证据驱动的任务执行合约。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-tasks。 它的用途是：为AI Agent提供Pi原生的、证据驱动的任务执行合约。 完整的 Skill 内容见：https://321skill.com/skills/pi-tasks/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用pi-tasks规划并执行一个数据备份流程，第一步是验证源数据库连接，证据是返回‘连接成功’的JSON；第二步是导出数据，证据是生成指定大小的备份文件。” 它会创建一个有序计划，并在执行每个步骤时，等待你提交符合预设证据格式的结果，只有证据被验证通过，该步骤才会标记为完成，整个流程才得以推进。
介绍
pi-tasks 旨在解决AI Agent在执行复杂、多步骤任务时，因缺乏可靠的执行状态管理和结果验证机制而导致的混乱、中断或不可信问题。它通过提供一套Pi原生的执行合约，将任务执行过程结构化、证据化。
使用时，开发者可以将任务分解为有序的计划，并为每个步骤设定完成所需的“证据”（如特定格式的输出、文件创建等）。AI Agent在执行过程中，必须提交满足预设证据条件的证明，才能将任务标记为完成，从而实现证据驱动的、可验证的执行流程。
它非常适合需要构建可靠、可审计的自动化流程的开发者，例如那些开发需要处理长周期、多依赖任务（如项目构建、数据流水线、内容审核流程）的AI Agent或自动化脚本的工程师。
建议在需要确保任务执行结果可信、且可能因各种原因中断后需要安全恢复的场景中使用。注意，它需要集成到基于Pi框架的Agent开发流程中，并非一个开箱即用的独立工具。
核心特点
核心在于“证据门控完成”和“压缩安全恢复”。它不仅要求任务步骤有序，更强制要求每个步骤必须提交可验证的证据才能算完成；同时其状态恢复机制经过特殊设计，能抵抗底层存储的“压缩”操作（如区块链状态修剪），确保长时间运行的任务在中断后能精准续跑，这是许多同类任务管理库不具备的特性。
注意事项
不适合用于对执行实时性要求极高、或任务步骤无法明确定义证据的简单一次性脚本场景。
常见问题
pi-tasks 是什么？
它是一个为AI Agent设计的Pi原生任务执行合约库，通过证据验证来管理任务完成状态。
‘压缩安全恢复’是什么意思？
指任务执行状态即使在底层存储系统进行数据压缩或修剪后，也能安全、准确地恢复并继续执行，防止状态丢失。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-tasks/raw/index.md 读取 pi-tasks 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-tasks/raw/index.md（查看排版版本）