mcpField
J
jigx

jigx

github.com/jigx-com开发049 次安装6 周前更新
代码仓库

关于 jigx

面向使用 Jigx Core SDK 修改应用的开发者，提供按任务查阅参考资料的工作方法。内容强调本地优先的数据处理、检查生成代码以及发布前验证运行流程。

主要功能

  1. 01按任务查找 SDK 参考资料
  2. 02保持本地优先的保存行为
  3. 03确保 YAML 与 TypeScript 一致
  4. 04发布前验证应用流程
  5. 05避免硬编码凭据

适用场景

  1. 01实现数据源或表单变更
  2. 02构建父子页面流程
  3. 03行为不明确时检查生成的 YAML
  4. 04验证变更后的提交或同步流程

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jigx-com/skills --skill jigx

安装后在 Claude Code 中输入/jigx确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
app-architecture.md
datasources.md
forms-state-navigation.md
jsonata-validation-formatting.md
media-pdf-javascript.md
recipe-index.md
runtime-verification.md
tabs-sections-lists.md
scripts/
check-runtime.mjs
check-runtime.test.mjs

详细介绍

Jigx Core SDK

编写或更改 Jigx 应用代码前，请先使用此技能。仅阅读任务所需的参考文件。

工作流

  1. 确定要更改的应用区域：数据源、表单、导航、选项卡、媒体、PDF、JavaScript 函数、验证或构建/部署。

  2. 阅读 references/recipe-index.md，然后阅读该区域对应的特定参考文件。

  3. 保留本地优先行为：先在本地保存用户的工作，再通过明确的操作触发远程或生成的工作。

  4. 在父子流程中使用稳定的本地 ID。打开子屏幕前先生成父项 ID，并通过输入传递该 ID。

  5. 确保生成的 YAML 与 TypeScript 保持一致。如果 SDK 输出不明确，请检查生成的 YAML，不要自行推断运行时行为。

  6. 学到新模式时，在实现之前或同时更新相关参考文件。

  7. 对于新方案或更改后的表单/同步/提交流程，请在实现前阅读 references/runtime-verification.md。发布前运行其中生成的检查器，并验证受影响的目标应用流程。 仅通过编译并不能证明行为正常。

参考文件索引

  • references/recipe-index.md - 何时阅读各参考文件。

  • references/app-architecture.md - 项目布局、常量、构建/部署顺序。

  • references/datasources.md - 本地表、SQL、JSON 提取、搜索、刷新。

  • references/forms-state-navigation.md - 表单、保存操作、脏状态、输入、父子 ID、复制流程。

  • references/tabs-sections-lists.md - 选项卡式工作区、分区、列表项、滑动操作、标题操作、底部操作。

  • references/media-pdf-javascript.md - 媒体字段、文件路径、HTML/PDF 生成、脚本、分享/重新生成流程。

  • references/jsonata-validation-formatting.md - JSONata、验证、格式化、下拉列表、图标和字段约定。

  • references/runtime-verification.md - 生成的检查、设备流程、调试证据和验证声明。

防护措施

  • 不要硬编码机密、令牌、组织 ID 或客户专属凭据。
  • 除非应用明确采用直接提交流程，否则不要在主要保存操作中调用外部 API。
  • 不要混淆读取刷新与写回的边界；支持离线的写入应通过用户可见的操作完成。
  • 不要将设备本地文件路径存储为可在设备间通用的路径。
  • 保存父记录或子记录时，不要用 jig 状态代替稳定的屏幕输入。
  • 不要假设生成的 YAML 符合预期。行为不明确时，请检查 YAML。

评论

支持 Markdown