用途:用于编写技术规格文档,把技术内容与视觉元素结合,形成可读性高的规范。
主要能力:按五阶段推进,依次为 VISION(明确问题、选择自然隐喻、定义范围与读者)、SKETCH(写 YAML frontmatter、创建不超过20行的 ASCII 头图与引言)、REFINE(写概述与目标、架构、技术栈、API/Schema、安全、实施清单,并加入至少一个 ASCII 流程图、UI 草图、对比表和代码块)、POLISH(应用 Grove 文风并校验格式)、LAUNCH(终审并发布)。提供规范模板、图表模式和 EARS 需求格式等参考资料,可调用 references/spec-template.md、references/diagram-patterns.md、references/ears-format.md。
使用方式:用户要求写规范、记录功能或设计系统时激活,也可通过 /swan-design 调用。文风上要求不用 em-dash、不用 AI 套话(如 robust、seamless、leverage)、不用魔法副词与填充过渡,段落保持两到三句,可用自然隐喻和诗性收尾。可与 owl-archive 配合打磨文风。
适用场景:新功能或系统规格、架构决策、UI 组件、API 设计、审查既有规范。若读者是探索者而非开发者,改用 museum-documentation。
限制:资料未提供安装命令、价格、平台支持与运行环境信息。内容需以实际资料为准,不应编造。