语构设计 / 常见问题
开始之前,先了解这些
了解语构如何接入现有工具、延续已有工作,以及承载你自己的专业方法。
Yugoo 是另一套 Skills 吗?
不是。我们想探索的是一种与 AI 一起使用技能、完成构思设计的方式。语构设计系统(Yugoo Design)以开源插件的形式,安装在你已有的 Agent 应用里,把专业方法、交互面板、主动引导和项目管理结合起来。
做复杂的工作时,我们希望你能参与方案形成的过程:看清 AI 提出了什么,想一想哪些地方符合实际、哪些需要调整,再把自己的判断表达出来。为此,语构把三个环节连在了一起:
1. 把信息变成可以查看和修改的成果。 我们为技能配上适合其内容的设计面板,扩展成设计技能包(Bundle):流程可以画成图,规则可以放进表格,方案可以用卡片并排比较。你可以边看边与 AI 讨论,也可以直接修改,再让 AI 根据保存的结果继续工作。这些面板通过声明式 UI 和 A2UI 定义,让专业方法有合适的交互形式。
2. 让 Agent 像顾问一样主动引导、主动整合。 好的顾问会先了解你想达到什么目标、已经做了什么、还有什么没想清楚,再从工具箱中选择合适的方法。我们希望 Agent 也能这样工作:推荐有用的下一步,检查不同部分的结论能否对得上,指出需要协调和调整的地方,帮助你把它们整合成一份完整的方案。
3. 把讨论留下来,成为可以长期维护的项目。 方案会保存在项目中。下次想法改变,或需要进一步展开时,你可以回到已有成果继续修改、比较版本,让前面的讨论和判断积累下来。
我们相信,好的 AI 应用应该让人理解、促人思考、帮人表达,让 AI 与人对齐。你既能深入查看局部细节,也能把这些细节组织成一份完整的方案。
插件自带的 Web App Kit 是一个体验这些功能的起点。它包含智能问答、功能、流程、权限和 UI/UX 等设计能力,帮助你在开始 Vibe coding 前推敲应用。每种能力都配有相应的面板,你可以查看和修改具体内容,也可以检查这些设计放在一起是否合理。你还可以改造这套 Kit、为它添加 Bundle,或为其他工作创建新的 Kit。
已有的 Skills 也可以参与其中。例如,Matt Pocock 的 Grilling(原 Grill Me) 提供了很好的提问与决策澄清方法。语构希望让这类方法发挥更大的作用:有些事情适合通过问答想清楚,有些事情画成流程、放进表格或并排比较,更容易发现问题、表达取舍;讨论得到的结论,也可以进入项目,供后续继续使用。
Web App Kit 也参考和学习了 Grilling、UI/UX 设计等社区技能。你可以把自己常用的 Skill 导入并适配成设计技能包(Bundle),保留其中的专业方法,再配上适合的成果结构和交互面板。我们希望语构与已有技能相互成就,一起探索人与 AI 持续协作的方式。
产品理念语构只适合 Web App 或产品设计吗?
不是。我们把 Web App Kit 作为随插件提供的起点,是为了让你能先用一套现成的方法,体验语构怎样帮助人构思和设计。
构思设计也发生在很多其他工作中。策划活动,需要推敲议程、参与者和分工;设计游戏,需要考虑规则与玩家选择;安排班次,需要兼顾岗位覆盖、时间限制和个人偏好。这些工作同样需要专业方法,也同样会遇到信息难以看清、取舍难以表达的问题。
在语构里,一个 Bundle 聚焦一种工作或一个设计维度;设计套件(Kit)则围绕一个目标,把多个 Bundle 组织起来。每套 Kit 的 Mindset(mindset.md)用来说明这个领域应当怎样思考、怎样使用这些方法。调整 Mindset、Bundle 的内容及其面板,就可以让语构服务于不同的工作。
我们欢迎大家把熟悉的领域方法整理成 Kit 或 Bundle,并分享实际使用的经验,让语构逐渐适用于更多场景。
套件分享与项目维护不同 Agent 客户端的使用体验有什么区别?
语构沿用你所在 Agent 应用的模型、会话和工具。最直观的区别,是你在哪里查看和修改设计面板:
1. DeepSeek Harness(DSH)原生插件。 面板直接嵌在主对话旁边,你可以一边讨论,一边查看和修改方案。语构也能利用宿主的后台子代理,进行审查和提出设计建议。
2. Codex Desktop、WorkBuddy 的内嵌页面。 你可以在 Agent 应用中对话,同时在内嵌页面中操作面板。Codex Desktop 目前提供 macOS arm64 的接入路线;WorkBuddy 使用内嵌预览。
3. Codex CLI、Claude Code CLI、Qoder CLI 和千问办公(QwenWork)的网页 Companion。 语构会打开一个本地网页来展示面板,并连接原来的宿主会话。你可以在网页中查看对话、继续交流,减少窗口之间的来回切换。
另一个实际区别是:自动审查能否与你正在进行的对话同时工作。 支持后台子代理的客户端,可以让子代理检查已有方案,你则继续与主 Agent 讨论;检查完成后,再查看它提出的建议。
如果客户端不支持这种后台执行,审查就需要由当前 Agent 来做。这时,对话会先用于检查方案,完成后再继续原来的工作。你可以关闭自动 GRA,在需要时主动发起检查,经你确认后再进行。
如果你还没有确定客户端,我们目前优先推荐 DSH 和 Codex Desktop。选择前也可以查看项目 Wiki 的宿主兼容说明,确认你的操作系统、客户端版本和接入方式。
宿主兼容说明必须回答所有问题、走完全部面板吗?
不需要。语构会结合你的目标、已有成果和还没想清楚的问题,推荐下一步适合做的事。推荐的目的是帮助你推进工作,不要求你按顺序填完所有问答和面板。
你可以直接说“先给我一版方案”“只比较这两个选择”,或“这个问题先放一放”。已经清楚的部分,可以让 AI 继续展开;涉及实际情况和重要取舍的地方,再一起讨论。
Kit 的 Mindset 也可以定义不同的工作方式。如果某项工作适合固定步骤,就可以约定按顺序使用多个 Bundle;如果需要边探索边判断,也可以让 Agent 根据当前情况推荐下一步。
产品理念什么是 KAG 和 GRA?
KAG 是项目里的知识图谱。 它把设计内容、原始资料及它们之间的关系组织起来,帮助你查看各部分如何联系。例如,修改一个审批流程时,可以顺着关联找到对应的角色权限、业务规则和页面,看看哪些地方也需要一起检查。这些关联保存在本地,当前使用 LadybugDB 存储。
GRA 是语构的设计审查能力。 我们希望 AI 在帮你展开方案的同时,也能指出值得重新推敲的问题。它从三个角度提出建议:
- 一致性审查(Grounding):流程、规则、页面等部分能否对得上,设计是否符合已有资料和约束。
- 知识反思(Reflection):哪些判断还缺少依据,哪些问题值得进一步查证或研究。
- 意图对齐(Alignment):哪些需求还没有说清楚,哪些选择还需要你确认。
你可以主动要求检查;在支持后台执行的客户端中,也可以按设置自动审查。结果会作为建议交给你,由你判断哪些值得处理,再继续修改方案。
知识关联与审查指南构思成果如何保存,之后还能继续维护吗?
可以。我们为每次构思建立独立的设计项目,把设计数据、相关资料、产物以及项目使用的 Kit、Bundle 定义保存在本地文件夹中,并用 Git 跟踪版本和修改历史。
这样,一次对话结束后,方案仍然在。下次打开项目,或者换一个对话继续,你可以从已有成果出发。需求变化时,也可以让 AI 比较两次保存的差异,回看某条规则什么时候改过,以及当时留下了哪些说明。
我们希望构思能逐步成为一个可以长期维护的项目。项目文件保存成果与历史;Agent 客户端的聊天记录和设置,仍由客户端管理。
项目管理与恢复已经有项目、文档或代码,还能使用吗?
可以,取决于你手里已有的是什么:
- 已有语构项目,可以打开后接着做。较早版本的设计项目,可以按迁移指引保留原件,在新项目中继续校验和适配。
- 已有文档、截图或代码,可以让 AI 根据材料重建设计,整理出流程、规则、页面等内容,再与你逐项核对。原文件不会因此被改写。
在 DSH 中,根据材料重建设计使用 /yugoo reconstruct <材料绝对路径>;migrate 用于迁移已有的语构设计项目。
已有材料可以帮助你接着原来的工作往下做。不过,有些需求和取舍可能从未被写下来,AI 仍需要向你了解这些背景,才能确认整理出的方案是否符合实际。
从既有材料重建设计我该如何管理、定制 Kit、Bundle 和交互面板?
Studio 是语构管理和定制 Kit、Bundle 的工作台。你可以先查看一套 Kit 包含哪些方法、每个 Bundle 解决什么问题,再决定怎样调整它们。
例如,某个 Bundle 的专业方法很适合你,但它展示的信息不够用,你可以修改需要保存的内容、相应校验和 UI Panel;如果缺少一项能力,也可以新建或导入 Bundle,再把它加入 Kit。导入已有 Skill 时,可以保留其中的方法,再补上成果结构和交互面板。在支持这些创作操作的 Studio 版本中,你可以集中编辑和预览这些内容。
使用 DSH 时,可以从设置中的“设计工作室(Studio)”进入,也可以问 Agent:“怎么打开 Studio?”项目 Wiki 中介绍了各客户端的入口,以及相应版本支持的编辑和导入方式。
定制指南可以怎样参与语构的共建?
我们希望语构能够用于更多人的实际工作。不同领域需要什么方法、怎样的面板才方便,很多细节都要在使用中才能逐渐想清楚。欢迎把你的工作场景带进来,告诉我们哪里不好理解、哪里难以表达,以及希望 AI 怎样配合你。
你可以补充其他 Agent 客户端的接入,把熟悉的方法整理成 Kit 或 Bundle,改进交互面板,分享案例,或完善文档。也欢迎把你喜欢的 Skill 带进来,一起尝试怎样让它与语构配合。
不必一开始就做一整套。一个实际问题、一份能跟着操作的例子,或一处让人少走弯路的文档改进,都是有用的贡献。可以先在 GitHub Issue 中交流,也可以通过 PR 提交改动;具体方式见贡献指南。
贡献指南