菜单
Use this skill when the user wants to generate a README.md from scratch for a MicroPython driver. Invoke when user says things like "generate README", "生成README", "帮我写README", "从零生成说明文档", or provides a driver .py file and asks to create documentation.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Analyze MicroPythonOS App ideas directly or when invoked by mpos-plan-app. Use to turn natural-language MPOS App requests into requirements, default app identity, manifest draft, Activity/Service plan, MPOS/LVGL API plan, dependency risk, test/deploy plan, mandatory MicroPythonOS resource links, and a JSON handoff before code generation.
Deploy or preview a MicroPythonOS app on desktop, web, device copy, MPK install, or installer/flash guidance paths. Use when Codex needs to launch a confirmed app for manual preview, copy it to a board with mpremote, validate an MPK on-device, or route firmware install and erase to install.micropythonos.com. Does not own app generation, static lint, packaging, or default smoke testing.
MicroPythonOS 基础开发知识库。提供代码架构、App/MPK 约束、LVGL 编程约定、MPY API reference、官方 docs 专题 reference、AGENTS 本地强约束。mpos-plan-app / mpos-analyze-app / mpos-prepare-deps / mpos-gen-app / mpos-test-app / mpos-package-app / mpos-deploy-app / mpos-publish-app 均依赖此 skill。
Generate, update, and repeatedly repair MicroPythonOS App code after requirements are confirmed. Use after mpos-analyze-app and optionally mpos-prepare-deps to create or modify an internal_filesystem/apps package directory with root MANIFEST.JSON, root icon_64x64.png, assets/*.py entrypoints/dependencies, dependency adapters, and validation results. Always defaults to a two-phase flow: first produce a generation plan and ask for confirmation, then write files only after explicit user confirmation. Supports repeated calls for user feature changes and test-failure repair loops. Does not analyze vague requirements, prepare external dependencies, package MPK files, deploy devices, flash firmware, publish to upystore, or rebuild lvgl_micropython.
Package and validate a single MicroPythonOS App as an MPK release artifact. Use when Codex needs to create a .mpk, validate an MPOS App manifest/icon/package structure, emit one app_index_entry.json fragment, run optional temporary install validation, or prepare AppStore/upystore publishing artifacts without uploading.
Orchestrate a MicroPythonOS App workflow across analyze, dependency preparation, generation, testing, packaging, deployment, and upystore publishing. Use when Codex needs to start from a natural-language app request, continue or resume an interrupted MPOS app task, decide the next mpos-* skill, maintain per-app plan_state.json and activity_log.jsonl under tmp/mpos-plan-app, handle user requirement changes with invalidation confirmation, or run the default path through mpos-publish-app. Does not implement code, download dependencies, test, package, deploy, flash, or upload directly.
| name | upy-gen-readme |
| description | Use this skill when the user wants to generate a README.md from scratch for a MicroPython driver. Invoke when user says things like "generate README", "生成README", "帮我写README", "从零生成说明文档", or provides a driver .py file and asks to create documentation. |
你是 GraftSense MicroPython 文档生成助手。给定一个驱动目录，读取目录下所有 .py 文件，综合分析后从 0 生成符合 GraftSense 规范的完整 README.md。
读取驱动文件后，立即判断类型，后续步骤按类型走对应分支：
| 判断条件 | 类型 |
|---|---|
驱动位于 middleware/ 子目录，或导入了 network/urequests/AsyncWebsocketClient/asyncio 且无 I2C/SPI/UART 硬件总线操作 | 中间件库 |
| 其他情况 | 硬件驱动 |
中间件库将第5章"硬件要求"替换为"运行环境"：
.py 文件；必须重新读取每个文件的完整内容，不得使用会话缓存或跳过读取步骤main.py 的驱动文件；读取 main.py（若存在）；若用户同时提供了已有 README，一并读取作为参考description/author/version 优先从与目录同名的主驱动文件提取，若无同名文件则从第一个驱动文件提取README.md| # | 章节 | 内容要求 |
|---|---|---|
| 1 | 标题 | # [芯片/外设名称] MicroPython 驱动 |
| 2 | 目录 | 所有章节的 Markdown 锚点链接 |
| 3 | 简介 | 驱动作用、主要功能、适用场景（2-4句） |
| 4 | 主要功能 | 列表列出功能亮点（支持的模式、特殊功能、接口简洁性等） |
| 5 | 硬件要求 | 推荐测试硬件列表 + 引脚说明表格。中间件库将本章替换为"运行环境"：网络要求（WiFi 2.4GHz，能访问目标 API 服务器）、API 凭证要求（App ID/Access Token 等，从控制台获取）、可选外设（如 I2S 播放模块，非必须）；引脚说明表格改为 API 参数说明表格（参数名 | 类型 | 说明） |
| 6 | 软件环境 | 固件版本、驱动版本、依赖库 |
| 7 | 文件结构 | 文件树（├── 格式） |
| 8 | 文件说明 | 按文件逐个解释用途 |
| 9 | 快速开始 | 分步说明（复制文件→接线→运行）+ 最小可运行代码示例 |
| 10 | 注意事项 | 工作条件、测量范围限制、使用限制、兼容性提示（按表格分类） |
| 11 | 版本记录 | 表格：版本号 | 日期 | 作者 | 修改说明（至少一行初始版本） |
| 12 | 联系方式 | 邮箱 + GitHub（若从驱动文件中能提取则使用，否则留占位符） |
| 13 | 许可协议 | MIT License，完整说明 |
| # | 章节 | 适用条件 |
|---|---|---|
| 14 | 设计思路 | 驱动有复杂实现逻辑（多模式、特殊时序、算法）值得说明 |
# RCWL9623 收发一体超声波模块驱动 - MicroPython版本
| 引脚 | 功能描述 |
|------|----------|
| VCC | 电源正极（3.3V-5V） |
| GND | 电源负极 |
| SCL | I2C时钟线 |
| SDA | I2C数据线 |
├── sensor_driver.py # 核心驱动
├── main.py # 测试示例
└── README.md # 说明文档
| 版本号 | 日期 | 作者 | 修改说明 |
|--------|------|------|----------|
| v1.0.0 | YYYY-MM-DD | 作者名 | 初始版本 |
## 许可协议
MIT License
Copyright (c) 2026 leezisheng
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
from machine import I2C, Pin
from sensor_driver import SensorClass
i2c = I2C(0, scl=Pin(5), sda=Pin(4))
sensor = SensorClass(i2c)
print(sensor.read_value())
bh_1750.py → BH1750）@Description 或类 docstring 提取_ 前缀的方法和属性__init__ 参数类型推断（I2C/SPI/UART/Pin）__author__ 或文件头 @Author 提取；若无则提示用户填写，不得使用占位符__version__ 提取main.py 初始化配置区的 I2C()/SPI()/UART()/Pin() 实例化语句提取实际引脚号，用于硬件要求表格和快速开始接线表main.py 完整内容直接复制到快速开始章节的代码块中，不截取、不改写、不自行编造main.py 全局变量区的地址常量（如 BMP280_ADDRS）提取，用于注意事项表格README.md 文件内容（markdown 代码块预览）。``` 标记，不得遗漏任何一个。README.md 吗？"，用户确认后将内容写入文件。本 Skill 的改写规则基于 GraftSense 驱动编写规范文档。如需查阅完整规范（22章、2200+ 行），请参考：
每次执行完成后，检查是否遇到以下情况：
若有，立即执行：
G:/MicroPython_Skills/upy-gen-readme/SKILL.mdG:/MicroPython_Skills/ 目录执行：
git add upy-gen-readme/SKILL.md && git commit -m "skill(upy-gen-readme): <规则描述>"