@wichayutdew/pi-workflows
声明式可暂停的Pi工作流框架
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@wichayutdew/pi-workflows。 它的用途是：声明式可暂停的Pi工作流框架 完整的 Skill 内容见：https://321skill.com/skills/wichayutdew-pi-workflows/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'用 Pi Workflows 创建一个定时采集温湿度数据并上传到云端的工作流，要求在每次采集后暂停30秒避免传感器过热。' 它会生成一个 YAML 配置文件，定义采集、上传、暂停三个步骤，并自动处理状态保存与恢复，执行时每隔30秒采集一次数据，直到手动停止。
介绍
在树莓派（Pi）上运行自动化任务时，常常面临资源紧张、执行中断、流程难以管理等问题。Pi Workflows 提供了一套声明式、可暂停的工作流框架，让你能够像写配置文件一样定义任务流程，并在需要时随时暂停和恢复执行，从而更灵活地控制 Pi 上的计算资源与任务节奏。
使用方式非常简单：通过 npm 安装后，在项目中编写 JSON 或 YAML 格式的工作流定义文件，描述任务步骤、依赖关系和暂停策略。框架会自动解析并执行，遇到暂停条件（如等待传感器数据、手动确认）时挂起当前状态，待条件满足后继续运行。支持多种暂停模式（定时、信号、事件等）。
适合在树莓派上进行自动化开发、硬件原型验证、数据采集、边缘计算等场景的开发者。尤其适合需要长时间运行但又希望灵活控制任务执行节奏的智能体开发、后端开发或运维工程师。
建议在运行前确保 Pi 系统资源充足，并合理设置暂停超时时间。对于需要严格实时响应的任务（如电机控制），建议使用专用实时系统，因为暂停机制会引入额外延迟。首次使用时可以先用示例工作流测试暂停/恢复功能，再逐步应用于复杂场景。
核心特点
与通用工作流引擎（如 Airflow、Temporal）相比，Pi Workflows 专门针对树莓派硬件环境优化，资源占用极低，且内置了暂停/恢复机制，无需额外状态管理工具，更适合边缘设备上的轻量级自动化任务。
注意事项
不适合对毫秒级实时响应有严格要求的场景，暂停机制可能引入额外延迟。
常见问题
Pi Workflows 支持哪些树莓派型号？
理论上支持所有运行 Node.js 的 Pi 型号（Pi 3B+、Pi 4、Pi 5 等），推荐使用 1GB 以上内存。
暂停功能如何工作？
在工作流定义中使用 pause 指令，指定暂停条件（如等待时间、事件、手动确认），框架会序列化当前状态到磁盘，恢复时重新加载执行。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/wichayutdew-pi-workflows/raw/index.md 读取 @wichayutdew/pi-workflows 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/wichayutdew-pi-workflows/raw/index.md（查看排版版本）