app-state-diagram
从ALPS配置文件生成RESTful应用状态图和交互式文档的工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：app-state-diagram。 它的用途是：从ALPS配置文件生成RESTful应用状态图和交互式文档的工具。 完整的 Skill 内容见：https://321skill.com/skills/app-state-diagram/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我有一份描述在线书店API的ALPS文件 `bookstore.xml`，请帮我生成一个交互式的状态图文档。” 它会指导你使用 `asd bookstore.xml` 命令，并在浏览器中打开生成的 `index.html` 文件，展示一个可点击跳转的应用状态图。 或者，你可以说：“我想把架构图嵌入到项目的README里。” 它会建议你使用 `asd --mode=svg bookstore.xml` 来生成SVG格式的图片文件。
介绍
app-state-diagram 解决了在设计和理解复杂RESTful应用时，状态流转和信息结构难以直观把握的问题。它通过解析描述应用语义的ALPS配置文件，自动生成清晰的可视化图表和可交互的文档，让开发者能一眼看清应用的全貌和数据流动。
使用方式非常灵活。你可以通过在线编辑器快速体验，无需安装；也可以通过Homebrew或Composer在本地安装命令行工具。只需提供一份XML或JSON格式的ALPS配置文件，运行命令即可生成HTML、Markdown或SVG格式的输出，并支持实时预览模式。
这个工具非常适合后端开发、全栈开发和架构师等角色，他们在设计API、评审系统架构或向非技术团队成员解释业务逻辑时，需要一个统一的视觉语言来沟通。产品经理也能借助生成的图表更好地理解系统能力。
建议在项目设计初期就引入ALPS描述和此工具，以确保设计的一致性。对于已有项目，可以尝试为其编写ALPS描述来反向生成图表，这有助于发现潜在的设计问题。注意，它主要服务于设计和文档阶段，并非运行时监控工具。
核心特点
与通用绘图工具不同，它直接从机器可读的ALPS语义描述文件生成图表，确保设计与文档的严格同步；生成的HTML文档是交互式的，支持点击跳转，远超静态图片的体验。
注意事项
不适合为没有明确定义ALPS语义描述或非RESTful架构的应用生成图表。
常见问题
什么是ALPS文件？
ALPS是一种用于描述Web应用语义（如资源、状态、操作）的格式，可作为API设计的蓝图。
生成的图表可以嵌入到文档里吗？
可以，使用 `--mode=svg` 选项会生成独立的SVG文件，方便嵌入到Markdown或其他文档中。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/app-state-diagram/raw/index.md 读取 app-state-diagram 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/app-state-diagram/raw/index.md（查看排版版本）