用途
Awesome Builder 用于帮助用户把 awesome 风格仓库从平铺的资源堆叠,转变为可导航、可维护的项目。该技能面向仓库维护者,聚焦结构、可用性、范围与策展质量,而不是针对某个具体仓库做单条目的收录判断。
适用场景
当用户询问以下内容时使用此技能:
- 如何构建一个 awesome 项目
- 如何重构 awesome README
- 为什么某个 awesome 列表难以使用
- 如何改进入门引导、分区布局或贡献流程
- 如何让策展型仓库对新用户更友好
不适用场景
当用户有以下需求时,不应将此技能作为主要工作流:
- 想判断某个具体条目是否应收录进 Awesome-Virtual-Cell
- 需要把论文、数据集或基准分类到 AIVC 的某个分区
- 需要实时的文献更新
工作流程
- 在给出结构建议前,先阅读当前的 README.md。
- 当贡献流程、格式规则或提交预期属于问题的一部分时,阅读 CONTRIBUTING.md。
- 阅读 references/awesome-guidelines.md。
- 推断仓库当前的问题形态:
- 入门引导薄弱
- 范围不清
- 分区顺序不佳
- 条目格式不一致
- 平铺条目过多
- 贡献指引薄弱
- 先诊断后开方,先识别最关键的 2 到 5 个问题。
- 推荐能实质改善可用性的最小结构改动。
- 优先给出仓库层面的建议,例如:
- 页面顶部入口层
- 分区重排
- 收录与排除规则
- 条目模板规范化
- 贡献流程改进
- 让每条建议都对应到当前仓库中的具体后果,而不只是通用的 awesome 列表原则。
- 默认使用中文,除非用户使用英文书写。
输出约定
优先采用面向维护者的精简结构:
主要问题:
- ...
建议调整:
- ...
推荐结构:
- ...
维护规则建议:
- ...
当用户需要更具体的改版方案时,额外包含:
最小改版路径:
- ...
- ...
- ...
质量规则
- 优化可扫读性,而非最大化分类。
- 偏好轻量分类,避免僵化的过度分类。
- 当仓库较大或新用户较多时,建议增加 Start Here 入口层。
- 保持分区名称稳定且直观。
- 在提出完整重写前,优先做小而高杠杆的改动。
- 将结构建议锚定到当前的 README.md 与 CONTRIBUTING.md,而不是想象中的通用仓库。
参考文件映射
仅加载当前设计诊断所需的文件:
- README.md -> 当前分区顺序、条目层与导航结构
- CONTRIBUTING.md -> 贡献流程与提交预期
- references/awesome-guidelines.md -> awesome 项目的结构模式、反模式、条目模板与维护启发式
限制
资料未提供该技能的收费方式、支持平台、具体安装命令与效果数据,相关信息暂未提供。