用途
本技能面向 awesome-gpui 项目列表的日常维护,用于新增或更新项目条目,覆盖分类、URL、图片、排序、schema 校验与 README 生成检查等环节。
主要能力
- 维护 projects.json 中的项目条目,不修改 README.md 的改动。
- 统一使用项目的权威 https:// URL;GitHub 链接会自动获取 stars 与活跃度,其它托管平台显示 N/A。
- 依据 schema 选择分类:应用类项目必须填写 schema 定义的子分类,其它分类不得填写子分类。
- 可选图片字段须为 HTTPS URL,优先采用仓库托管的稳定方形图标,而非截图或徽章。
- 保持描述简洁并沿用现有风格。
使用方式
编辑 projects.json 后,按顺序运行以下命令:
uv run check-jsonschema --schemafile projects.schema.json projects.jsonuv run scripts/sort_projects.pyuv run scripts/sort_projects.py --checkuv run scripts/generate_readme.py随后在本地检查生成的 README.md,确认元数据变化符合预期,再运行git restore README.md后再提交;合并后的工作流会更新 README。
适用场景
适用于向 awesome-gpui 列表添加项目或更新已有项目信息,包括分类归属、链接、图标和排序调整。
限制与注意事项
- 不得在拉取请求中提交 README.md 的改动。
- 需确认排序仅改变位置,且 GitHub 重定向使用权威 URL。
- 绝不提交 .env 或生成的 Python 字节码。