Cardputer Buddy 应用开发助手
为已完成配置的 Cardputer-Adv 设备添加、推送和调试 MicroPython 应用。
技能范围明确为已完成 provision 的 Cardputer，并仅描述向指定设备推送文件、读取串口日志和执行 REPL 命令；未见凭据窃取、隐蔽外传或破坏性默认行为。扣分原因是缺少逐次操作确认、权限边界、数据流说明、敏感信息处理、失败回滚和来源验证说明；REPL 与文件推送可能产生外部设备副作用。仓库提供 Apache-2.0 和 Anthropic 归属，但这些只能支持授权与归属，不能替代安全控制。
文档给出了目录布局、三个主要脚本及端口示例，正常路径较清晰。扣分原因是未提供测试、版本或依赖验证，也未说明设备未连接、端口错误、脚本失败、文件不存在、REPL 异常或传输中断时的诊断与恢复方式；静态审查不能证明命令可运行，因此不超过 10 分。
目标用户、设备前置条件、典型场景和触发词较明确，且支持 macOS、Linux、Windows 端口示例。扣分原因是没有说明不适用范围、设备型号/固件限制、Python 依赖、权限要求或中文交互支持；依赖本地 build-with-claude 克隆、m5-onboard 和 USB 串口环境，触发边界仍不完整。
SKILL.md 采用简短的前置说明、设备布局、添加应用和开发循环结构，示例命令和入口文件明确；仓库层面提供 Apache-2.0、维护组织和版本固定修订信息。扣分原因是技能自身缺少安装/依赖说明、参数定义、常见故障、已知限制、变更记录和具体维护责任/更新路径；README 的仓库级信息不能完全补足技能文档。
技能直接覆盖添加应用、增量推送、串口观察和一次性 REPL 操作，命令示例具有直接可用性，且增量推送相较重新刷写具有明确价值。扣分原因是没有提交的代表性输出、成功判据、验证步骤或替代方案比较，无法静态确认脚本与路径在目标环境中确实完成任务；按静态校准不超过 7 分。
可审计证据主要是固定修订中的技能文本、仓库许可证和部分 CI 配置；技能本身没有测试套件、执行日志、成功输出或第三方复现证据。扣分原因是关键命令和效果仍依赖未提供的文件与真实设备，结论只能有限复核；静态审查不允许超过 5 分。
- 执行 push.py、install_apps.py 或 repl_run.py 前应确认目标串口和设备，避免向错误设备写入或执行命令。
- 应补充 Python/固件依赖、失败输出、传输中断处理、备份与回滚步骤，以及 REPL 可能读取或修改设备文件的数据流说明。
- 当前文档未证明命令在中国大陆网络或中文工作流中的可达性与可用性；USB 本地流程可能降低网络依赖，但相关前置工具仍未说明。
它能做什么 & 适用场景
该技能面向已经通过 m5-onboard 完成配置的 Cardputer-Adv。它围绕 Claude Buddy、Snake 和 Hello 应用组成的 MicroPython 应用包，支持新增应用、增量推送文件、查看串口日志和执行一次性 REPL 命令。设备启动时会扫描 /flash/apps/，因此推送新的 Python 文件后即可将其加入菜单。它适合需要快速迭代设备端代码的开发者，但不负责设备首次配置。
在本地 build-with-claude 克隆中的 buddy/ 目录工作；参考 hello_cardputer.py 添加应用；运行 install_apps.py 推送应用包；运行 push.py 通过 USB 串口推送指定文件；运行 tail_serial.py 查看设备日志；运行 repl_run.py 执行一次性 REPL 脚本，例如列出 /flash/ 内容。
- 开发者已完成 m5-onboard 配置，想为 Cardputer-Adv 增加一个新的 MicroPython 应用。
- 开发者只修改了 apps/snake.py，希望通过 USB 串口推送单个文件而不重新刷写设备。
- 调试设备端应用时，需要持续查看 Cardputer-Adv 的串口日志。
- 开发者需要在设备 REPL 中执行一次性命令，例如检查 /flash/ 下的文件。
- 完成 /maker-setup 后，继续迭代 Cardputer Buddy 应用包。
优缺点一览
- 覆盖新增应用、单文件推送、串口日志和一次性 REPL 四类具体开发操作。
- 支持不重新刷写设备的增量迭代流程。
- 利用启动菜单自动扫描 /flash/apps/，新增 Python 文件即可成为菜单项。
- 设备必须已经通过 m5-onboard 完成配置，技能不覆盖首次安装或刷写流程。
- 依赖 Cardputer-Adv、MicroPython、USB 串口和本地命令行环境。
- 提供的材料没有测试套件、兼容设备清单或故障排查说明。
- 仅明确给出 macOS、Linux 和 Windows 端口示例，其他平台没有证据支持。
如何安装
该技能属于 anthropics/claude-plugins-official 仓库中的插件集合。README 说明可在 Claude Code 中运行 /plugin install {plugin-name}@claude-plugins-official 安装插件，但提供的材料没有说明此技能对应的具体 plugin-name，也没有给出独立安装命令。使用前还需先通过 m5-onboard 配置设备。
如何使用
在已配置设备的项目中，可使用“add an app”“push to the cardputer”“tail the device”或“run on the device”等触发语句。新增应用可参考 buddy/device/apps/hello_cardputer.py，然后运行 python3 onboard/scripts/install_apps.py --port <PORT> --src buddy。推送单个文件可运行 python3 buddy/scripts/push.py --port <PORT> --files apps/snake.py；查看日志运行 python3 buddy/scripts/tail_serial.py --port <PORT>；执行一次性 REPL 命令运行 python3 buddy/scripts/repl_run.py --port <PORT> --script "import os; print(os.listdir('/flash'))"。将 <PORT> 替换为 detect.py 最近报告的设备端口。