SuperAPI AI 工具集

create-ref-arch-skeleton

写作与研究

查看项目

更新于 10-29 04:44

技能介绍

用途

该技能用于为新的参考架构(Reference Architecture,RA)生成语法正确的骨架,包含文件夹结构与初始 front matter。目标是让用户能够方便地开始添加自己的内容。它并不打算创建内容完整的参考架构。

主要能力

  • 根据用户提供的主题,设置 front matter 中的标题、描述、关键词和标签等元数据。
  • 按照既有规范生成参考架构的文件夹结构。
  • 基于 RA0000 的 readme.md 模板构建 readme.md,但不复制 front matter 中的注释。
  • 提供占位内容:复制 demo.drawio 作为初始 drawio 文件;在 readme.md 中添加两个示例标题及 Lorem Ipsum 段落;使用一次 drawio 组件并引用复制后的 demo.drawio。
  • 询问用户的 GitHub 用户名,用于设置 front matter 的 author 字段,并将其列入 contributors;在此之前可使用 octocat 作为占位,并主动建议可尝试代为查找用户名。

使用方式

使用前,用户必须提供主题或想法,简短描述即可。若用户未提供主题,技能会解释为何需要主题并再次询问。确定主题后,技能会阅读内容结构、front matter、组件、RA0000 模板和标签文件等规范,以确保骨架符合要求。

适用场景

适用于用户要求创建、添加、脚手架化或贡献新的参考架构时,帮助其快速获得可直接填充内容的初始结构。

限制

  • 不预先添加子页面,除非用户明确要求。
  • front matter 字段之间不留多余空行。
  • 优先使用现有标签,仅在绝对必要时才向标签文件添加新标签。
  • 绝不在 front matter 中包含 category_index,该字段已废弃并将被移除。
  • 不偏离既定的结构规范。