插件 0.1.1 列表与软件包展示¶
- 作者: @n3wth
- 状态: Proposed。维护者范围批准待定。
- 日期: 2026-11-04
- 范围 issue: #122。原始候选:PR #302。独立的审查单元将取代该 PR。
- 候选提交:
b903f35,在不对软件包做任何更改的情况下,向53077c3d64c42fc906f18373892a8e63a1ce9d6e添加了中立性接收测试。
概述¶
在插件清单及其生成的副本之间使用简洁一致的文本。在插件列表中使用发布方的 Google 隐私政策链接,并保留仓库许可证作为条款依据。保留现有的 GitHub 支持链接和网站 URL。准备版本 0.1.1,包含入门 prompts、每个技能的默认 prompts、PNG 图标以及可移植清单的 schema 声明。
本设计涵盖列表展示。它并不确立发布方政策批准或原生应用支持。
The Problem¶
当前插件摘要使用内部工作流术语和冗长描述。目录隐私链接与发布方隐私政策不一致。读者在安装前需要清楚地了解插件的用途。
原始 PR #302 超出了小版本补丁的限制。它修改了全部七个规范技能描述及其生成的副本。本提案提供了一条独立的设计审查路径,并未主张范围例外。
目标¶
- 用平实的语言描述创意开发、文档准备和独立审查。
- 在规范文件和生成文件中为每个技能使用同一段简短描述。
- 将 OpenAI 列表类别设置为 Productivity。
- 保持
https://egm.dev作为网站链接。 - 保持仓库的 issues 页面作为支持链接。
- 为
privacyPolicyUrl使用https://policies.google.com/privacy,并保留https://github.com/google/elephant-goldfish-model/blob/main/LICENSE作为termsOfServiceUrl。 - 保持清单文件符合 schema,并确保生成的 Claude 文件与软件包输出一致。
- 添加三个插件入门 prompts,并为七个技能各添加一个默认 prompt。
- 保留 EGM 前缀的技能名称和稳定的技能标识符。
- 打包七个 256x256 的 PNG 技能图标,在 OpenAI YAML 元数据中引用它们,并保留 SVG 源文件。
- 在可移植清单中声明 Agent Plugins 1.0.0 schema,并将各宿主版本对齐到 0.1.1。
- 使用用户提供的审查标准测试不完整的 prompts、无关请求和非软件提案。
非目标¶
- 更改技能说明、审查者权限或执行逻辑。
- 添加宿主、执行器、工具或网络服务。
- 将目录发布视为原生工作流支持的证明。
- 更改网站文档系统或托管方式。
- 声称 Google 官方支持该项目。
- 用服务条款声明替代软件许可证。
开放问题¶
- 发布方必须检查所链接的政策页面适用于该插件。
- 维护者必须批准贡献范围和阶段标签。
- 审查者必须检查更简短的描述是否仍有助于技能选择。
关键用户旅程¶
理解列表¶
- Given: 读者打开插件列表。
- When: 读者阅读其摘要和技能列表。
- Then: 读者无需内部审查者术语即可识别插件的主要任务。
- Then: 列表不会暗示超出既有执行器和宿主限制的支持。
查看政策与支持信息¶
- Given: 读者查看开发者字段和政策字段。
- When: 读者打开网站、支持、隐私或条款链接。
- Then: 每个字段都会打开其声明目的地,不存在损坏的仓库路径。
技术方案¶
首先更新规范根清单。使用上方固定候选提交处的元数据值,而不是可变的 PR 头部提交。该提交定义了列表字段、能力以及全部七个替换描述。仅在既有 schema 支持该字段时更新兼容性清单。保留平台特定字段和本地执行器要求。不要添加 manifest schemas 拒绝的字段。
缩短七个规范技能文件中的 frontmatter 描述。保持每个技能的名称、工作流正文和相对引用路径不变。在每个技能的 agents/openai.yaml 中添加默认 prompts 和 PNG 图标路径。工作流正文保持不变。新元数据将改变用户发现和调用这些工作流的方式。保留 EGM 前缀的技能名称和现有品牌颜色。将七个 PNG 文件添加到包构建器的资源清单中。保留 SVG 源文件,用于现有的插画和调色板检查。在 .plugin/plugin.json 中保留 schema 声明。为兼容 omp,不要在根 plugin.json 中包含 $schema。将根、Claude、Codex、Cursor 和可移植宿主版本对齐到 0.1.1。使用现有包构建器重新生成 Claude 运行时。不要独立编辑生成的副本。
冗长的列表描述不得作为执行限制的唯一记录。安装文档保留隔离审查者要求、部分云支持和宿主权限边界。项目支持免责声明仍保留在仓库和网站中。发布方审查必须在合并前检查措辞和政策链接目的地。
Alternatives Considered¶
仅更改兼容性清单¶
该选项能快速更改可见列表,但会使规范元数据不一致。现有的一致性测试会拒绝这种状态。
保留当前冗长的技能描述¶
该选项保留了详细的触发语言,但在面向用户的目录中保留了内部阶段名称。所选候选方案使用简短描述,同时保留每个技能中的完整工作流文本。
将每个技能描述拆分为单独的小版本 PR¶
该选项会人为划定范围边界,使文案一致性更难以审查。将所有七个描述放在同一个列表和 prompt PR 中。
发布列表文本但不包含提示词或 PNG 资源¶
此选项减小包差异,但将发现与首次调用保留为单独的审查决策。 发布版将列表文本与提示词、PNG 资源以及发布者政策目标分别作为独立审查单元。 每个单元包含其测试和生成的文件。功能单元保留阶段 2 门控。 默认提示词仅暴露现有工作流。它们不会绕过缺失输入检查,也不会授予编辑文档的权限。
仅保留 SVG 图标引用¶
该选项避免新增七个额外的源资源。候选方案改为为宿主选择器提供固定尺寸的 PNG 资源,并保留规范 SVG 图稿。 PNG 文件提供一种独立的宿主资源格式,而不是宿主修复通用图标问题的证据。 将原生图标渲染保留为一项明确的验证缺口。
可移植 schema 声明和对齐的版本描述的是同一个包候选方案。 应一起检查 schema 与生成的资源清单,而不是引入独立的包系统。
非功能需求¶
- 保留清单模式有效性,以及计划元数据更新和七个新增 PNG 资源之外的包内容。
- 不添加运行时请求或依赖。
- 保留读者无需仓库写入权限即可打开的公共政策与支持链接。
- 如果发布者拒绝被驳回的元数据字段,则回退这些字段并重新生成运行时。
详细实现¶
固定候选方案更改 55 个文件:31 个源文件、宿主文件和测试文件,外加 24 个生成的 Claude 文件。 十四个文件是 PNG 资源:七个规范文件和七个生成的副本。 七个规范技能主体保持不变。
源文件、宿主文件和测试文件(31 个)¶
.claude-plugin/marketplace.json..claude-plugin/plugin.json..codex-plugin/plugin.json..cursor-plugin/plugin.json..plugin/plugin.json.README.md.plugin.json.scripts/pack_plugin.py.skills/egm-bootstrap/SKILL.md.skills/egm-bootstrap/agents/openai.yaml.skills/egm-bootstrap/assets/icon.png.skills/egm-brainstorm/SKILL.md.skills/egm-brainstorm/agents/openai.yaml.skills/egm-brainstorm/assets/icon.png.skills/egm-draft/SKILL.md.skills/egm-draft/agents/openai.yaml.skills/egm-draft/assets/icon.png.skills/egm-drift-report/SKILL.md.skills/egm-drift-report/agents/openai.yaml.skills/egm-drift-report/assets/icon.png.skills/egm-resolve/SKILL.md.skills/egm-resolve/agents/openai.yaml.skills/egm-resolve/assets/icon.png.skills/egm-review-loop/SKILL.md.skills/egm-review-loop/agents/openai.yaml.skills/egm-review-loop/assets/icon.png.skills/egm-review/SKILL.md.skills/egm-review/agents/openai.yaml.skills/egm-review/assets/icon.png.tests/integration/test_codex.py.tests/unit/test_packaging.py.
清单定义列表文本、政策链接、受支持的提示词、schema 声明和版本 0.1.1。
README 将软件工作流与对其他文档的可配置审查区分开来。
七处 SKILL.md 更改仅更新 frontmatter 描述。
七处 YAML 更改在保留技能名称的同时添加默认提示词和 PNG 路径。
包构建器包含新的 PNG 文件。
单元测试检查 schema 声明、提示词标识符、技能名称、PNG 尺寸和资源一致性。
原生测试覆盖不完整的起始提示词、无关请求以及非软件提案。
生成的 Claude 文件(24 个)¶
使用现有包构建器重新生成这些文件。不要独立编辑它们。
distributions/claude/.claude-plugin/plugin.json.distributions/claude/README.md.distributions/claude/plugin.json.distributions/claude/skills/egm-bootstrap/SKILL.md.distributions/claude/skills/egm-bootstrap/agents/openai.yaml.distributions/claude/skills/egm-bootstrap/assets/icon.png.distributions/claude/skills/egm-brainstorm/SKILL.md.distributions/claude/skills/egm-brainstorm/agents/openai.yaml.distributions/claude/skills/egm-brainstorm/assets/icon.png.distributions/claude/skills/egm-draft/SKILL.md.distributions/claude/skills/egm-draft/agents/openai.yaml.distributions/claude/skills/egm-draft/assets/icon.png.distributions/claude/skills/egm-drift-report/SKILL.md.distributions/claude/skills/egm-drift-report/agents/openai.yaml.distributions/claude/skills/egm-drift-report/assets/icon.png.distributions/claude/skills/egm-resolve/SKILL.md.distributions/claude/skills/egm-resolve/agents/openai.yaml.distributions/claude/skills/egm-resolve/assets/icon.png.distributions/claude/skills/egm-review-loop/SKILL.md.distributions/claude/skills/egm-review-loop/agents/openai.yaml.distributions/claude/skills/egm-review-loop/assets/icon.png.distributions/claude/skills/egm-review/SKILL.md.distributions/claude/skills/egm-review/agents/openai.yaml.distributions/claude/skills/egm-review/assets/icon.png.
添加上面列出的 14 个 PNG 资源。不删除任何源文件。不更改任何依赖。
审查单元与合并顺序¶
- PR #314 跨清单更新发布者隐私政策目标,同时保留仓库许可用于条款。它面向
main分支,需要发布者批准。 - PR #316 包含列表文本、技能描述、插件起始提示词、schema 元数据、版本以及 Cursor 清单检查。它面向
main分支。 - PR #317 包含每个技能的 OpenAI 默认提示词及相应的包测试和原生提示词测试。它面向 #316 分支。
政策 PR 是独立的。维护者可以拒绝它,而不阻塞其他单元。
功能 PR 保持门控状态,直到本设计合并且 issue #122 获得实现批准。
先合并 #316 到 main,再合并 #317。
316 合并后,将 #317 变基到 main,重设其 PR 目标,并重复检查与审查。¶
不要将 #317 合并到临时父分支。 列表审查恢复列表文本中现有的支持免责声明和部分云限制。 经验性检查表明,PNG 技能图标不会改变宿主选择器显示的内容,因此实现保留 SVG 技能图标。 这种拆分遵循维护者对独立目的和更小差异的要求。它不会为功能创建次要补丁例外。
所需审批¶
- 为第 1 阶段获得维护者范围批准和
design-ready问题标签。 - 在实现合并之前,先合并本设计并获得
pr-ready问题标签。 - 更新规范元数据并比较各清单中支持的字段。
- 重新生成 Claude 运行时并检查精确差异。
- 运行单元测试,打包两个目标,并审查清单文本。
- 完成对策略目的地的独立人工审查和发布者审查。
这些标签名称遵循当前仓库的 PR 模板。 审查就绪并不构成范围批准,也不构成合并替代功能 PR 的许可。 Issue #122 仍是发布范围参考。本设计未完成其发布要求。
所需测试¶
- 在合并技能描述更改之前,完成 发布分支设计 中的 Claude 分发切换。在发布者和市场路径得到验证、清单所有者确认分支切换之前,保留生成的目录。
- 对于每个通过描述发现技能的支持主机,在全新会话中一次只安装一个包,使用相同的任务提示(prompt)比较当前包和提议包。为每个更改的技能提供省略其名称的匹配提示,并包含不应选择任何 EGM 技能的相邻请求。
- 记录每个案例的主机与模型版本、包修订版本以及观察到的技能加载或缺失情况。要求预期技能能够加载,且不出现新的漏检或误触发。单独记录不支持或未测试的主机。显式的 starter-prompt 调用算作工作流检查。
- 运行完整的仓库单元测试套件。
- 使用
scripts/pack_plugin.py构建 OpenAI 和 Claude 包。 - 检查清单模式(schema)有效性和共享元数据的一致性。
- 检查生成的 Claude 与规范包输出是否逐字节相等。
- 检查所有主机版本是否与 0.1.1 一致,并检查所声明的 Agent Plugins 1.0.0 模式。
- 检查所有七个默认提示(prompt)是否包含预期的技能标识符。
- 检查 PNG 签名、256x256 尺寸、图标路径、保留的 SVG 源文件和包资源一致性。
- 检查技能主体和现有引用路径是否未更改。
- 针对确切的 OpenAI ZIP 运行可选的原生测试,并保留其校验和及已安装文件比较结果。
- 检查不完整的 starter prompt 是否不会凭空生成文档或启动审查者。
- 实际调用 starter prompt 时,不要附上关于缺少输入或审批的额外说明。要求响应能主动询问缺失的输入。
- 检查无关的算术请求不会启动审查。
- 检查两个隔离的审查者阅读非软件提案和标准时,不对提案做任何更改。
- 打开网站、支持、隐私和条款等目标地址。
- 获取发布者对策略适用性和类别选择的审查。
通过离线测试并不构成原生安装或完整云审查支持的证明。 自定义图标渲染仍未验证。PNG 资源检查不能证明 Codex 会显示这些图标。 除非范围、设计、发布者和人工审查要求全部通过,否则该实现不得合并。
在仓库根目录并使用文档记录的测试环境,运行以下命令:
python -m pytest tests/unit -q
python3 scripts/pack_plugin.py --target openai --output <temporary-directory>
python3 scripts/pack_plugin.py --target claude --output <temporary-directory>
git diff --check
git diff 0dfb5bf b903f35 -- skills/
使用 Claude 包命令重新生成 Claude 运行时,然后用生成的 egm-claude 目录替换已检入的运行时。
tests/unit/test_frontmatter.py 检查元数据结构。
tests/unit/test_packaging.py 检查生成的运行时与规范包输出的一致性。
审查每个 SKILL.md 差异,确认只有 frontmatter 描述发生更改。
YAML 元数据和 PNG 新增内容是技能目录内单独计划的更改。
仅在实现候选版本上通过显式选择加入来运行付费原生测试:
EGM_CODEX_RELEASE_ZIP=/absolute/path/to/egm-openai-0.1.1.zip \
EGM_CODEX_LIVE=1 python -m pytest tests/integration/test_codex.py \
-k 'starter_prompt or nonsoftware or unrelated_prompt' -v
已报告的候选证据¶
修订后的 starter 测试仅调用清单提示(prompt),不附带关于缺少输入或许可的说明。
在 b903f35 上,使用 Codex CLI 0.166.0 在 50.28 秒内通过三个原生 starter 案例。
最终回答会请求缺失的输入。不会出现审查者启动或 Markdown 文档。
单元测试套件通过 336 个测试,并跳过两个可选的原生探测。
测试所用 ZIP 的 SHA256 是 47178bb1b08d3b3ef4b663991bbd4b6542a64f91edfcaa30b9a7c2552d1c2df2。
重新构建的包与该压缩包一致。该修订仅更改测试,因此包的字节内容保持不变。
PR #302 描述报告了 53077c3d64c42fc906f18373892a8e63a1ce9d6e 的这些结果。
本设计更新记录了该报告。它不会重新运行测试或检查原生追踪结果。
- 单元测试套件:336 个通过,两个可选的原生主机探测跳过。
- 上述精确 ZIP 原生子集:五个在 103.67 秒内通过。
- 三个不完整提示(prompt)案例不会启动审查者或凭空生成文档。
- 算术请求保持在审查工作流之外。
- 两个全新上下文的审查者阅读所提供提案和标准,发现缺少所有者和财务信息,并保持提案不变。
- 报告指出,模式验证、存档完整性、校验和、接口一致性和可复现工件比较均通过。
- 报告指出,最终 OpenAI ZIP 与用于那五个原生测试的压缩包一致。
报告还记录了两次更早的软件工作流和隔离测试,它们在更早的候选版本上于 457.62 秒内通过。 这些测试在模式和标签更改后不再重新运行。它们并未确立七次 exact-head 原生测试通过。 自定义图标渲染、发布者策略适用性、目录发布和 Web 主机支持仍未被这些测试验证。
设计审查记录¶
全新上下文的审阅者将 EGM 设计批评与实现就绪度评估标准应用于此前的提案。 本次修订将范围扩展到已固定的 0.1.1 候选版本,并盘点了全部 55 个变更文件。 此前的审查并未确立对扩展范围的批准。 本次修订的独立审查、发布方政策审查以及完整 EGM 协议仍处于待定状态。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 el/elephant-goldfish-model