Communitygithub.com

Francixco90/metodologia-frames-agent-os

此技能用于根据结构化规范编译多语言工作坊路线落地页,并支持验证、渲染和审查流程。

metodologia-frames-agent-os 是什么?

该技能专注于从结构化规范生成通用工作坊培训路线落地页,支持西班牙语、英语和葡萄牙语三语种,并确保规范锁定、渲染和验证的完整性。它严格按照八节结构(entry、tension、route、method、resources、outcomes、trust、invitation)工作,使用内联SVG作为CTA,且不依赖JavaScript、外部资源、时钟、随机数或表单,完全离线运行。技能包含合约创建、编译、验证和审查四个操作步骤,生成的页面具备无JS支持、打印友好、键盘导航以及双重复核(cross-process byte-idénticas)等特性。它适用于Cursor、Claude Code、Codex等开发者工具,要求用户仅操作规范文件,而不编辑HTML输出,且不允许发布或请求网络。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Francixco90/metodologia-frames-agent-os/tree/HEAD/03_artefactos/skills/metodologia-workshop-route-landing-html

在你喜欢的 AI 中提问

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

文档

MetodologIA 工作坊路线落地页 HTML

从结构化规范编译通用的培训路线落地页。保持课程内容在技能之外:此能力提供合约、合成渲染和验证,而非真实活动或发布权限。

操作流程

  1. 规范:创建 workshop-route-landing-spec-v1,包含精确的八个部分、ES/EN/PT 三语种一致性、设计系统锁定 hash 绑定、一到三个词的 CTA,以及声明为 available 或 pending 的资源。通过 sha256-canonical-json-v1 计算 specSha256,仅排除该字段。
  2. 编译:仅使用已验证的规范。转义所有内容,保持声明的顺序,并生成自包含的 HTML、manifest 和 receipt。在 CTA 中使用内联 SVG;不使用网络、时钟、随机性、追踪、表单或远程依赖。
  3. 验证:验证 schema、hash、八个部分、三语种一致性、资源状态、相对链接、无 JS、打印友好、原生键盘,以及两次跨进程逐字节相同的编译结果。
  4. 审查:保留 RENDERED_DRAFT 和 candidate。记录 coverage_gap,直到验证器、守护者和 H01 完成独立门控。不要发布。

不变量

  • 精确使用:entry、tension、route、method、resources、outcomes、trust、invitation,按此顺序。
  • 保持 ES、EN、PT 之间的 ID 和顺序一致;翻译文本,绝不翻译 ID。
  • 每个可见 CTA 限制为一、二或三个词,并为操作链接配以内联装饰性 SVG。
  • 仅显示 available 资源的链接;pending 资源无 href 或虚假操作。
  • 保留内容、导航和可用资源,无需 JavaScript。使用原生 HTML 链接和控件,保持可见焦点。
  • 打印时隐藏导航和 CTA,不丢失八个部分的内容。
  • 阻止绝对路径、私有定位器、编辑 URL、无权限资产、表单、遥测以及任何标记 READY 或 PUBLISHED 的尝试。
  • 从规范重新生成;绝不手动修正编译后的 HTML。

命令

node skills/metodologia-workshop-route-landing-html/scripts/compile-fixture.mjs \
  skills/metodologia-workshop-route-landing-html/fixtures/positive/valid-spec.json \
  <输出目录>
node skills/metodologia-workshop-route-landing-html/scripts/check-skill.mjs

在调整渲染器之前,请先阅读 references/operating-contract.md。查阅 references/capability-boundary.yml 了解执行限制。此技能不请求网络也不发布内容。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能