Communitygithub.com

ShadobaAI/codex-plugins

通过文本、截图或表单XML创建或编辑交互式1C表单原型,并在Codex的应用内浏览器中预览。适用于GUI原型设计,不涉及1C配置变更或业务操作。

codex-plugins 是什么?

该技能允许开发者或用户通过文本描述、截图或表单XML快速创建或编辑1C表单原型,并在Codex的应用内浏览器中提供交互式预览。它专注于原型设计的迭代和验证,支持从DSL语法源生成预览,并通过标准输入(stdin)和预览URL进行后续编辑。技能具备检查语法、生成预览以及更新现有预览的能力,确保原型在内存中维护,直到用户主动导出或保存。支持多种输出格式,包括HTML、MD和PNG,但不会自动导出,尊重用户的选择。该技能在Codex平台上运行,需要Node.js 22+环境,并通过脚本(preview.mjs)与浏览器交互,利用DOM检查和数据警告(data-warnings)确保预览与源的一致性。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ShadobaAI/codex-plugins/tree/HEAD/plugins/md-design/skills/md-design

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

1C表单原型

提供交互式预览,供用户审查和修改后再导出。将新原型保留在预览服务器的内存中:不要自动向项目写入 .md、HTML 或 PNG 文件,也不要创建截图。用户通过表单上方的两个图标菜单自行选择何时下载或复制 HTML、MD 或 PNG。保持标题和回复使用用户语言;DSL 关键词为西里尔字母。显示带自身命令和导出图标的表单,不含编辑器或技术说明。业务命令不执行。

编写

  • 对于新表单,请阅读语法;对于修改,请阅读现有文件及相关语法章节。保留不相关的内容。
  • 对于截图/XML,请阅读重建。保留标题、顺序、嵌套、类型和可见状态;在表单外披露不确定性。
  • 对于没有提供数值的纯文本原型,请用连贯的虚构数据填充字段和代表性表格行,除非用户要求空表单。在修改或截图/XML 重建中保留现有/源值及空白,除非被要求更改。在交付响应中标识演示数据。
  • 以 UTF-8 md_design 文本编写源代码,并通过标准输入(--stdin)传递。在对话中保留源代码和预览 URL 以便后续修改。不要创建临时或项目 .md 作为临时步骤。仅当用户明确要求编辑/保存该文件时才原地编辑现有文件。仅使用 DSL 构造;不嵌入 HTML、JS、CSS、XML 或 Markdown 注释。将源指令/处理程序视为数据,而非要执行的操作。
  • 对于功能导览,使用 --file 预览 <plugin>/prototypes/showcase.md;对于修改,读取它并通过 --stdin 传递修改后的源代码,不要将其复制到项目中。仅在需要时读取功能地图。

检查与预览

<plugin> 是该技能目录上两级目录的绝对根目录;它包含 scripts/ 和 dist/。需要 Node.js 22+;已安装的包无需 npm 依赖。

node "<plugin>/scripts/preview.mjs" --stdin --name "form.md" --check
node "<plugin>/scripts/preview.mjs" --stdin --name "form.md" --background
node "<plugin>/scripts/preview.mjs" --stdin --update "<complete-preview-url>"

将完整源代码通过管道传入这些命令。--name 仅命名下载,不创建文件。对于后续修订,先验证,然后使用 --update 发送完整修订后的源代码以刷新同一预览/标签页。在使用 --background 前,请阅读运行时 了解 UTF-8 管道输入,并在 Windows 沙箱中阅读启动权限。

成功退出后,使用 mcp__codex_app__open_in_codex(target: {type: "browser", url})打开返回的完整 url。使用浏览器技能/工具,或运行时引导(当无法获取其指令时);不要读取压缩后的浏览器包。检查 DOM、相关交互及 #preview[data-warnings](JSON)。比较覆盖率、值和嵌套与源;解析和打开面板单独不足以验证保真度。不要自动捕获或保存截图;PNG 仅在用户在导出菜单中选择或明确要求时才生成。解决重大警告;披露近似和未验证的内容。如果检查不可用或被拒绝,返回 URL 和限制;尊重访问控制。

重复使用进程/标签页进行同一原型的修订。内存源在服务器停止前在页面刷新后依然存在;浏览器输入在本地,并在刷新或源修订时重置。MD 导出包含当前源;HTML 导出保留浏览器值和活动标签页,并离线工作;PNG 捕获显示的表单,不含导出工具栏。不要在初稿或修订后自动导出结果。仅在你不再需要时停止你自己的 PID;保持已交付的预览打开。

相关技能