SuperAPI AI 工具集

awesome-builder

写作与研究

查看项目

更新于 10-16 10:54

技能介绍

用途

Awesome Builder 用于帮助用户把 awesome 风格仓库从平铺的资源堆叠,转变为可导航、可维护的项目。该技能面向仓库维护者,聚焦结构、可用性、范围与策展质量,而不是针对某个具体仓库做单条目的收录判断。

适用场景

当用户询问以下内容时使用此技能:

  • 如何构建一个 awesome 项目
  • 如何重构 awesome README
  • 为什么某个 awesome 列表难以使用
  • 如何改进入门引导、分区布局或贡献流程
  • 如何让策展型仓库对新用户更友好

不适用场景

当用户有以下需求时,不应将此技能作为主要工作流:

  • 想判断某个具体条目是否应收录进 Awesome-Virtual-Cell
  • 需要把论文、数据集或基准分类到 AIVC 的某个分区
  • 需要实时的文献更新

工作流程

  1. 在给出结构建议前,先阅读当前的 README.md。
  2. 当贡献流程、格式规则或提交预期属于问题的一部分时,阅读 CONTRIBUTING.md。
  3. 阅读 references/awesome-guidelines.md。
  4. 推断仓库当前的问题形态:
    • 入门引导薄弱
    • 范围不清
    • 分区顺序不佳
    • 条目格式不一致
    • 平铺条目过多
    • 贡献指引薄弱
  5. 先诊断后开方,先识别最关键的 2 到 5 个问题。
  6. 推荐能实质改善可用性的最小结构改动。
  7. 优先给出仓库层面的建议,例如:
    • 页面顶部入口层
    • 分区重排
    • 收录与排除规则
    • 条目模板规范化
    • 贡献流程改进
  8. 让每条建议都对应到当前仓库中的具体后果,而不只是通用的 awesome 列表原则。
  9. 默认使用中文,除非用户使用英文书写。

输出约定

优先采用面向维护者的精简结构:

主要问题:

  • ...

建议调整:

  • ...

推荐结构:

  • ...

维护规则建议:

  • ...

当用户需要更具体的改版方案时,额外包含:

最小改版路径:

  1. ...
  2. ...
  3. ...

质量规则

  • 优化可扫读性,而非最大化分类。
  • 偏好轻量分类,避免僵化的过度分类。
  • 当仓库较大或新用户较多时,建议增加 Start Here 入口层。
  • 保持分区名称稳定且直观。
  • 在提出完整重写前,优先做小而高杠杆的改动。
  • 将结构建议锚定到当前的 README.md 与 CONTRIBUTING.md,而不是想象中的通用仓库。

参考文件映射

仅加载当前设计诊断所需的文件:

  • README.md -> 当前分区顺序、条目层与导航结构
  • CONTRIBUTING.md -> 贡献流程与提交预期
  • references/awesome-guidelines.md -> awesome 项目的结构模式、反模式、条目模板与维护启发式

限制

资料未提供该技能的收费方式、支持平台、具体安装命令与效果数据,相关信息暂未提供。