SuperAPI AI 工具集

design-it

编程与开发

查看项目

更新于 10-16 01:34

技能介绍

用途:把新的需求、规格或功能简介转成一份自包含的 HTML 技术设计文档,采用固定的“house style”,保证每次输出的页面视觉一致,而非每次重新发挥设计。也可用于把 .md 技术规格转成可分享的 HTML 形式。不适用于临时草稿、用户希望保留 Markdown 的正式交付物或幻灯片。

主要能力:技能目录内提供 template.html,复制模板后只替换内容,保留 <style> 块逐字节不变;文档由固定 section 骨架和固定样式组成。段落种类包括已对齐结论、业务规则、架构图、时序、数据模型、契约、清单、幂等降级、测试用例、代码索引、变更记录等,可按功能增删,但保持同风格。支持内联 SVG 架构图、提示框(.note/.tip/.warn)、状态标签 pill、表格与代码块。HTML 的 lang 为 zh,正文通常为中文。

使用方式:先复制 template.html,不手写 head/style;再从实际需求文档和代码库收集真实内容,包括章节标题、字段名、SQL、file:line 代码位置、protoId 等,读取代码而非臆造标识符;未知事实用 <span class="pill todo">待确认</span> 标记。填充骨架后将 TOC 与 section 的锚点保持一一对应,保存为 docs/<需求名>.html,未要求不要提交。

限制与注意事项:不得重新设计 CSS,颜色仅来自 :root 变量;<pre> 内的 <、>、& 必须转义,否则内容会被吞掉;TOC 的 href 与 section id 必须完全匹配,这是最常见错误;不能编造代码位置或标识符;产出是设计文档而非提案。最终可用文中命令自检 TOC 链接是否匹配,并用浏览器检查图表和代码块渲染。

资料未提供收费、平台支持、安装命令或价格信息。