SuperAPI AI 工具集

spec-loop-setup-doc-rendering

编程与开发

查看项目

更新于 10-15 21:12

技能介绍

用途:帮助配置和排查任务文件与术语表文件的渲染,适用于用户询问 PlantUML、AsciiDoc、VS Code、Cursor 及其他基于 VS Code 的 IDE 时。

主要能力:先自行从命令和项目本地配置收集证据,再报告哪些已正常工作、哪些缺失或损坏、哪些无法直接验证;随后建议创建小型 Markdown 和 AsciiDoc 探针文件做端到端渲染验证,探针需覆盖当前工作流预期的图表类型,且至少包含一个类图,也可包含时序图、组件图和 Mermaid 术语表图。

使用方式:按所选设置路径执行检查。JetBrains 路径用 command -v dot 和 dot -V 检查 Graphviz。VS Code 本地 PlantUML 路径检查 Java(command -v java、java -version)、Graphviz(command -v dot、dot -V)以及配置的本地 plantuml.jar 路径(test -f)。VS Code 服务器路径优先使用辅助脚本检查路径,除非排查指向本地路径,否则不运行 Java、Graphviz 或本地 plantuml.jar 检查。根据项目状态判断是否需要 AsciiDoc 支持,包括 glossary.adoc 或显式使用 Spec Loop AsciiDoc 术语表格式。优先使用项目本地证据,如 .idea/、.vscode/ 和工作区文件。VS Code、Cursor 等优先使用辅助脚本检查路径。

限制:除非用户明确批准,否则不检查仓库外的编辑器状态;无法从项目本地文件验证插件或 IDE 设置时,需先询问再检查外部编辑器配置目录。更改插件、扩展或 IDE 设置前需获得确认。VS Code 类 IDE 读取 vscode-setup.md,JetBrains 读取 jetbrains-setup.md,仅使用实际存在的设置文档。