Files
skill-template/assets

assets

  • actions.json:Skill Action manifest 最小示例(按入口定位表决定是否保留/扩展;见 development/PRODUCT_SURFACES.md)。每个 action 必须显式声明 executionProfile(sync | async)。默认仅 health / version / config-path,不放 toolbar,故无 bind 示例。
  • 业务技能注意: 若主路径在数据管理,准备/载入/导入类 Action 应挂 toolbar + bind.tables(用户看得见),不要只挂 skill-detail 却在教程里写成「技能详情点按钮」。见 development/TUTORIAL_SURFACES.md §5、references/ACTIONS.md「用户可见性」。
  • html/example-report.html:HTML 快照页最小壳({{TITLE}} / {{GENERATED_AT}} / {{BODY}});含数据管理 iframe 预览布局基线(流体铺满、禁横向滚动);渲染后须写入数据目录 html/。不要放进 pages/。
  • html/pages/*.html:装完就出现在侧栏的壳子页(宿主直接读安装包,不经生成)。页面用 jiangchang.call 调本技能已声明的命令。见 references/ACTIONS.md「HTML 页面报告」。模板仓库不要在这里放示例页。
  • data-sources.example.json:声明式数据源默认示例(SQLite {skillSlug}.db);宿主安装时可复制到用户目录。MySQL 参考见 examples/data-sources.mysql.example.json。
  • examples/:CLI 成功输出形状示例、Action 形状参考(含 data-sources.mysql.example.json、path-root-file-action.example.json、selection-label-column.action.example.json、selection-mode-optional.action.example.json、render-html.action.example.json 等;虚构路径与数据)。
  • schemas/:轻量 JSON Schema(skill-actions.schema.json 为新技能严格规范)。

skill-actions.schema.json 使用 additionalProperties: false。正式支持 bind.tables(toolbar Action 必填)与可选 bind.inputMapping / columnMapping / labelColumn(选择摘要标签列)/ selectionMode(required | none | optional:表勾选如何驱动 Action;省略则宿主兼容推断)。placements 含 toolbar / row / batch / cron / agent / skill-detail(对齐匠厂宿主)。数据管理 confirm/form 弹层在会应用勾选时展示「已选择」摘要;form + 有摘要时映射 readOnly 默认不占参数区(仍提交),可选 revealInForm 强制显示。弹窗 description / 确认黄条 / 参数说明须用户可见中文(勿写 pickCount/async/pending/CLI 子命令;见 ACTIONS.md「用户可见文案」)。可选 hoverHint 为数据管理工具栏悬停(省略不显示,不回退)。concurrency/locks 仍为预留。placements 与 executionProfile 正交——进任务中心只看 async,与入口无关。表级 Action 与 Agent 契约见 references/ACTIONS.md;开发深度规范见 development/SKILL_ACTION_RUNTIME.md。