SuperAPI AI 工具集

personalized-storefront-render

办公与效率

查看项目

更新于 10-15 09:42

技能介绍

Personalized Storefront Render 是一个基座型技能,目标是把内部产物翻译成面向客户的界面,并使用客户所在领域的语言表达。它不是一次性定制构建,而是可复用的基座。

用途

当用户要求“X 的客户版”“为 Rob/Maddie 翻译这个”“用简单语言解释或给出摘要”时,或希望某类内部产物都能投射到客户门店界面时,或新客户入驻需要个性化阅读界面时,或某个产物带有 audiences 前置元数据但门店界面尚未重新生成时,可以调用该技能。

当产物属于治理、SOP 或纯内部内容且没有客户界面时,或工作是为特定交付物做定制创意方向时,或客户界面已存在且由人工在基座之外维护时,不应调用该技能。

架构

该技能采用四层架构。第 0 层是角色语料,位于 ~/Documents/personas/,包含 {id}.md 散文来源和 {id}.lexicon.yaml 机器可读翻译表。第 1 层是内部产物,位于各客户仓库的 /docs/**,可选地扩展 YAML 前置元数据,如 audiences[]、tldr、strata、client_render_mode。第 2 层是翻译引擎,即本技能,组合产品领域引擎、八层领域理想整体、语气强制和词典替换,输出到 docs/storefront/_generated/<artifact>.<persona>.client.md,人工批准后进入 docs/storefront/_curated/。第 3 层是部署界面,按仓库和栈适配,例如 Hokage 通过 Next.js 发布 /storefront/[...slug] 到 rob.<domain>,Spiral 通过 Astro 发布到 maddie.<domain>,未来静态适配器可输出纯 HTML。

使用方式

该技能可从任意智能体调用,面向操作者的形式是 organvm storefront 子命令。主要命令包括:organvm storefront sync --repo <path>,遍历源 glob、读取 audiences 前置元数据、按角色渲染草稿到 _generated/,幂等;organvm storefront audit [--persona <id>] [--unmtagged],报告词典过期、未标记的客户相关产物、孤立精选文件、禁用词命中;organvm storefront ratify <artifact-slug> [--persona <id>],人工阅读后将草稿移入 _curated/ 并记录语气评分;organvm storefront status,输出一行状态;organvm storefront feedback add --persona <id> --note "...",追加客户反馈并创建 IRF.STO-FEEDBACK-* 条目。智能体调用时优先使用技能协议,实际渲染调用 CLI。

组合契约

该技能是协调者,不重复实现已有技能。产品领域引擎的第 4 阶段用于 logos→pathos 转换;domain-ideal-whole-substrate 的八层内部磁铁规则用于判断哪些源 glob 可投射到客户界面;voice-enforcement 根据角色 voice_constitution 字段指定的规则包对每份草稿评分;stranger-test-protocol 提供验证步骤,确保新智能体能在不调用 PDE 或本体术语的情况下识别角色领域语言。

基座拒绝渲染孤儿

每个门店渲染产物必须通过 bridge_to: lineage 追溯到真实内部产物。如果产物前置元数据暗示的路径不存在源文件,或 bridge_to: 引用的领域句柄不在角色词典中,或 audiences[].id 引用的角色在 ~/Documents/personas/ 中没有 {id}.lexicon.yaml 文件,基座拒绝输出 _generated/*.client.md。该规则防止个性化表演。

生命周期

内部产物创建或更新后,若存在 audiences 前置元数据,操作者按需运行 organvm storefront sync,渲染管线按受众条目输出草稿,voice-scorer 根据角色 voice_constitution 评分,IRF 自动为未批准草稿发出 STO-DRAFT-* 条目,操作者阅读并批准后进入 _curated/,仓库原生构建发布 /storefront/* 路由,客户收到 URL 并以自己的语言阅读,客户反馈通过 mailto 和 storefront feedback add 进入 STO-FEEDBACK-* 条目,下一次同步根据更新后的源和词典重新生成。没有守护进程,没有 LaunchAgents。可选仓库中的 pre-push git 钩子可在客户相关文件变更但未重新生成时发出警告(退出码 0),并提示应运行的确切 storefront sync 命令。

分阶段推出

截至 2026-04-25,第 1 阶段 Rob 门店已搭建脚手架,包括模式、Rob 词典、hokage-chess 配置、至少一个规范产物的前置元数据和人工精选草稿,但路由和部署推迟,因为 hokage Next.js 存在破坏性变更。第 2 阶段 Maddie 门店待定,包括 Astro 适配器、Maddie 词典、spiral 配置和 5 个 spiral 产物的前置元数据。第 3 阶段完整基座待定,包括自动草稿生成器、pre-push 钩子、IRF 接线、mailto 回馈、静态适配器和 audit --unmtagged 基线。

限制

该技能不适用于纯内部产物、定制创意方向或已由人工维护的客户界面。它依赖已有技能,不重复实现。它拒绝为无真实来源的产物渲染。当前部署状态和具体平台适配细节以资料为准,部分阶段尚未完成。