| name | add-hap |
| description | 向本仓库收录一个新的鸿蒙 HAP 应用。当用户提供一个 GitHub/Gitee 项目链接，要求"添加 Hap"、"收录应用"、"添加新项目"到 README 表格时使用本技能。 |
添加新 Hap 到合集
当用户提供一个新的鸿蒙 HAP 项目链接时，按以下步骤将其收录进 README.md。
第 1 步：收集项目信息
访问用户提供的项目链接（用 fetch 工具抓取 GitHub 仓库页面和 README），收集：
- 项目名：有中文名就用中文名（通常在 README 中），没有就用仓库英文名。
- 项目简介：根据 README 用中文写一句话简短描述软件功能（不超过 30 字左右，与表格中现有条目风格一致）。
第 2 步：判断目标分类表格
按优先级依次检查项目的 module.json5 中的 deviceTypes：
- 抓取
entry/src/main/module.json5（GitHub raw 链接形如：https://raw.githubusercontent.com/<owner>/<repo>/<branch>/entry/src/main/module.json5，分支通常是 main 或 master）。
- 如果是 Flutter 跨端项目，鸿蒙代码在
ohos 子目录，改抓 ohos/entry/src/main/module.json5。
- 分类规则：
deviceTypes 同时包含 phone、tablet 和 2in1 → 一次开发，多端部署- 包含
phone、tablet 但没有 2in1 → 鸿蒙手机/平板
- 只有
2in1 → 鸿蒙电脑
- 抓不到 module.json5 时，根据 README 判断；仍无法判断时，默认放入 一次开发，多端部署
第 3 步：获取最新 release 日期
访问项目的 releases 页面（https://github.com/<owner>/<repo>/releases），获取最新一次 release 的发布日期，格式化为 MM-DD（如 07-31）。如果最新 release 是去年发布的，使用 YYYY-MM-DD 格式。
第 4 步：写入 README 表格
在 README.md 对应分类的表格中追加一行，格式为：
| [项目名](项目链接) | [Link](releases链接) | 一句话描述。 | MM-DD |
示例：
| [FlClash](https://github.com/tljk/FlClash-ohos) | [Link](https://github.com/tljk/FlClash-ohos/releases) | 基于ClashMeta的多平台代理客户端。 | 07-31 |
注意：
- 表格按更新日期倒序排列（新的在前），将新行插入到日期正确的位置，不要直接追加到表尾。
- 保持表格列对齐风格与现有条目一致。
第 5 步：更新贡献者名单并生成 SVG
- 检查项目的开发者（仓库 owner 的用户名）是否已在
CONTRIBUTING.md 中（该文件每行格式为 - [显示名](https://github.com/用户名)，列表按首字母排序）。
- 如果已存在，流程结束。
- 如果不存在，将该开发者按
- [用户名](https://github.com/用户名) 格式插入到 CONTRIBUTING.md 的正确排序位置，然后在项目根目录用终端运行：
uv run .agents/skills/add-hap/scripts/contributers.py
（uv 不带参数运行，脚本需要 GITHUB_TOKEN 环境变量来获取头像。如果运行失败，报告错误并告知用户。）
