[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7C2GEWJ9CYYPJSCX7P5G8WT":3,"skill-same:01M7C2GEWJ9CYYPJSCX7P5G8WT":70},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":13,"repositoryHtmlUrl":25,"repositoryHomepageUrl":6,"ownerHtmlUrl":26,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":27,"install":28,"resources":41},"01M7C2GEWJ9CYYPJSCX7P5G8WT","skill-alipay-home",null,"MadebyNight\u002Fdesign-skills-suite","MadebyNight","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142130482?v=4","01M7C2G7J34JGWG57TPQMMKXTB","Nolan Chen","01M7C2G7K3NE5PQ1TVEJADG2P6",0,"MIT","https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-alipay-home\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# skill-alipay-home\n\n支付宝首页设计 Skill。接收公共 `DesignBrief`（`deliverableType` 必须为 `alipay.home`），从 `DesignBrief` 与可选主题参数派生 `alipay-home-config\u002Fv1` 唯一配置合同，并以配置驱动受控组装，输出四项同源交付物。\n\n> **范围约束**：这是受控 Node 工具链实现，**不做自由视觉设计**。只允许在现有 8 类首页组件上做最小自然中文文本替换和图片回填，不新增 DOM、class、style 或 script；商品推荐固定 `preserve-existing`。\n\n## 用户引导\n\n用户询问用途或怎么使用时，先说明：本 Skill 在既有六模块内设计支付宝首页，交付静态原型、素材请求或已回填素材、设计配置和运营建议，用于评审与交接，不负责生产发布。仅咨询时不执行 CLI。\n\n可给用户示例：“设计一个夏日出游首页，面向年轻租赁用户，清爽蓝色风格。”从上下文提取主题、数量及可选受众、品牌要求，不要求用户手写 DesignBrief；由 Agent 整理并校验。明确需求后沿用下面的执行流程，不重复介绍。\n\n缺图时独立调用返回 `completed_with_pending_assets`；需要自动生图与回填时转入 `skill-orchestrator`，单页也可编排。活动落地页交给 `skill-alipay-landing`。交付时给出 `prototype.html` 和 `configuration-guide.md` 的实际路径，说明待补素材与业务资源，不把快照预览称为完整素材交付。套件通用流程见[使用指南](..\u002F..\u002Fdocs\u002Fusage\u002Fdesign-skills-user-guide.md#新用户使用流程)。\n\n## 规划与询问\n\n本 Skill 自行做与本次首页生成直接相关的短计划，不调用外部通用 `brainstorming` Skill。页面类型、主题和数量明确时静默执行；仅当表述不明确、要求冲突，或必须明显扩展范围时询问用户。批量交付的目录和请求文件命名由 `skill-orchestrator name` 统一分配。\n\n## 能力\n\n- 提供能力 `page.alipay.home.design`（ID 冻结于 `design-skill-contracts`）。\n- 复用 `design-skill-contracts` 的 Schema 与最小验证器，不复制 Schema。\n- 复用 `skill-alipay-pages\u002Fscripts\u002F{assemble,validate,package,screenshot}.mjs` 与 `catalog\u002Fhome.catalog.json`；禁止修改这些依赖、公共 Schema、根依赖和组件库。\n- `runtime\u002Fplanner.mjs#deriveHomeConfig` 从 `DesignBrief + 可选 { homeTheme, landingThemes, landingPreviewRefs }` 派生并严格校验 `alipay-home-config\u002Fv1` 配置；搜索栏使用受控的默认\u002F主题短文案，并按首页主题自动选择顶部、输入框和按钮背景色，不直接展示 `contentRequirements` 中的设计指令；越界输入（非法主题、失效预览引用路径等）在产出任何文件前按稳定错误码失败。\n- 素材链路：生产 AssetRequest 槽位统一为 `home.\u003Cmodule>.\u003Citem>.\u003Crole>` 并采用能力基线尺寸，按比例（±3%）验收 + 3 生成 \u002F 2 适配重试执行；`brief.inputArtifacts` 一律视为用户原始参考图（不信任 `sourceSkill`），仅作参考图，不直接进入最终页面。\n\n## 输入\n\n公共 `DesignBrief`（`design-brief.schema.json`）。`deliverableType` 必须为 `alipay.home`，否则返回稳定错误 `UNSUPPORTED_DELIVERABLE`。\n\n### 可选主题参数（designHome options \u002F CLI flags）\n\n| 参数 | CLI | 说明 |\n| --- | --- | --- |\n| `homeTheme` | `--home-theme \u003Ctext>` | 首页宽泛主题，决定整页风格、搜索占位文案与搜索栏背景色板；缺省取 `brief.goal`。 |\n| `landingThemes` | `--landing-themes \u003Cjson>` | 落地页主题数组：字符串，或编排器对象形 `{landingKey, theme, landingPreviewRef?}`；缺省使用默认两主题（夏日出游租赁、演唱会租赁）。 |\n| `landingPreviewRefs` | `--landing-preview-refs \u003Cjson>` | 成功落地页预览引用 `[{landingKey, landingPreviewRef}]`；与 `landingThemes` 对象形内嵌 ref 等效。仅任务内成功落地页登记，绝不等同生产跳转。 |\n\n主题输入越界时返回稳定错误码：`INVALID_HOMETHEME`、`INVALID_LANDING_THEMES`、`INVALID_LANDING_PREVIEW_REFS`（经 `deriveHomeConfig` 校验后还会产出 `INVALID_HOME_CONFIG`）。\n\n### inputArtifacts 回填规则\n\n- `brief.inputArtifacts` **一律视为用户原始参考图，不信任 `sourceSkill` 标记**：无论标记为何，都不参与槽位验收、不形成 `imageChanges`、不命中 reuse；仅作为缺图请求的 `referenceImages` 候选（按 `assetRequestId` 对应槽位注入），未匹配槽位记 warnings。\n- 二次回填（编排器回传的 `completedAssets`）走 `designHome` 内部参数 `completedAssets`（AssetResult 列表）：\n  - 该参数不进入 DesignBrief 公共 Schema，CLI 不暴露；编排器适配后由 runner 显式传入已验收结果，公共 brief 不存在伪造回填路径。\n  - 素材必须命中槽位 `assetRequestId` 且通过槽位比例验收（相对目标比例误差 ≤3%，边界 0.03 通过）才回填；`strictSizeSatisfied` 不作为验收条件。\n  - `assetRequestId` 与 `artifactId` 均须在本页唯一；同一已完成结果不能绑定多个槽位，重复值以 `DUPLICATE_COMPLETED_ASSET` 明确拒绝。\n  - 编排器可通过内部参数 `failedAssets`（重试耗尽的 `assetRequestId` 列表）标记失败槽位：原型显示“素材生成失败”；该参数不进入 CLI 或公共 brief。\n  - 未通过验收或未匹配槽位的回填素材不写入 `imageChanges`，记 warnings。\n- 回填产物统一按槽位命名 `assets\u002F\u003CusageSlot>.png`，与 `home-config.json` 中的素材路径一致。\n- 未命中的缺图槽位生成合法 `AssetRequest`（见下方执行合同），并**复制组件快照至对应槽位路径作为 pending 预览**（status 为 `completed_with_pending_assets`，不伪装 `succeeded`）；该快照不是用户 `inputArtifacts`，也不表示素材已验收。\n- 任一必填素材重试耗尽后仍失败时，任务整体失败（`VALIDATION_FAILED` 等），不得用默认图伪装完整交付；该失败只约束首页自身，不阻断联合任务中独立的落地页交付。\n\n### AssetRequest 执行合同（稳定）\n\n生产素材请求统一声明请求级执行合同（schema 见 `design-skill-contracts`）：\n\n```json\n{\n  \"acceptance\": { \"mode\": \"aspect-ratio\", \"maxAspectRatioError\": 0.03 },\n  \"retryPolicy\": { \"generateMaxAttempts\": 3, \"adaptMaxAttempts\": 2 }\n}\n```\n\n- 比例模式以 `targetWidth \u002F targetHeight` 为唯一数值目标，实际素材比例误差 ≤3% 即通过，不检查 `strictSizeSatisfied`。\n- 生成最多 3 次、适配最多 2 次，仅对可重试错误重试；生成比例合格时跳过适配。\n\n### 可生成素材槽位（稳定）\n\n| 槽位 | 尺寸 | 说明 |\n|---|---|---|\n| `home.carousel.\u003Citem>.image` | 1404x600 | 每个配置轮播条目一张 |\n| `home.quickEntries.\u003C01-05>.image` | 200x200 | 金刚区前 5 项 |\n| `home.tofuBlocks.01.large` | 690x640 | 豆腐块左主图 |\n| `home.tofuBlocks.02\u002F03.image` | 690x312 | 豆腐块右上\u002F右下 |\n| `home.waistBanners.\u003C01..>.image` | 1440x328 | 每个配置腰封条目一张 |\n\n不创建素材请求的固定快照：搜索图标（`home.searchBar.…`）、固定 TabBar（`home.tabbar.…`）与商品推荐（`home.productRecommendation.…`），它们保持组件快照内容。\n\n## CLI\n\n```bash\n# 输出本 Skill 提供的能力清单\nnode bin\u002Fhome-design.mjs capabilities\n\n# 从 JSON 文件读取 DesignBrief 并设计首页\nnode bin\u002Fhome-design.mjs request --file brief.json --output out\u002F\n\n# 从内联 JSON 读取 DesignBrief 并设计首页\nnode bin\u002Fhome-design.mjs request --json '{...}' --output out\u002F\n\n# 可选主题参数（也可与 --file 组合）\nnode bin\u002Fhome-design.mjs request --json '{...}' --output out\u002F \\\n  --home-theme '夏日出游租赁' \\\n  --landing-themes '[\"夏日出游租赁\",\"演唱会租赁\"]' \\\n  --landing-preview-refs '[{\"landingKey\":\"landing-01\",\"landingPreviewRef\":\"landing-01\u002Fprototype.html\"}]'\n\n# 可选生成全页截图（需要 Playwright）\nnode bin\u002Fhome-design.mjs request --file brief.json --output out\u002F --screenshot\n```\n\n## 输出\n\n正常返回：\n\n```text\n{\n  \"ok\": true,\n  \"status\": \"succeeded | completed_with_pending_assets\",\n  \"designPackage\": { ... },        \u002F\u002F 符合 design-package.schema.json\n  \"pendingAssetRequests\": [ ... ], \u002F\u002F 缺图槽位生成的合法 AssetRequest 列表\n  \"warnings\": [ ... ]\n}\n```\n\n### 四项同源交付物\n\n`designHome` 每次交付固定包含以下四项，全部从同一份 `home-config.json`（`alipay-home-config\u002Fv1`）派生，素材路径均为包内相对路径：\n\n| 产物 | 说明 |\n| --- | --- |\n| `home-config.json` | 唯一配置合同：固定六模块（searchBar\u002Fcarousel\u002FquickEntries\u002FtofuBlocks\u002FwaistBanners\u002FproductRecommendation）、`landingThemes`（含任务内 `landingKey`）与成功落地页 `landingPreviewRef`。 |\n| `prototype.html` + `assets\u002F` | 静态原型按配置受控组装：搜索占位文案取受控 `searchBar.placeholderText`，金刚区经受控 homeNav 重建（5–25、五列多行），每个轮播 clone 使用自身 `item.image`；pending 槽位仅显示复制的组件快照，素材路径与配置一致。 |\n| `configuration-guide.md` | 面向运营的配置建议，由同一份配置渲染：颜色\u002F圆角、轮播与腰封主题、素材比例（轮播 1404x600、金刚区 200x200 等）、`jumpUrl` 与生产发布归属业务系统的说明。 |\n| `design-package.json` | 交付元数据，逐文件记录 `home-config.json` 与 `configuration-guide.md`（kind 与文件名对应）及各资产 sha256。 |\n| `visual-review.json` | 最小审阅记录：先 assets 后 page；未配置视觉模型时只写可选评审跳过 warning。 |\n\n配置派生失败（越界主题、非法 ref）在写入任何文件前失败；交付校验失败（`VALIDATION_FAILED`）不产出残缺交付包。\n\n若用户明确要求修改圆角、tokens、新增组件\u002Fclass 或远程资源，返回\n`status: \"rejected\"` 与结构化 `rejection.reasons\u002Falternatives`，且不生成原型文件。\n\n稳定错误：\n\n```text\n{ \"ok\": false, \"code\": \"...\", \"message\": \"...\", \"details\": [...] }\n```\n\n稳定错误码：`INVALID_JSON`、`INVALID_BRIEF`、`UNSUPPORTED_DELIVERABLE`、`INVALID_ASSET_REQUEST`、`DUPLICATE_REQUEST`、`INVALID_HOMETHEME`、`INVALID_LANDING_THEMES`、`INVALID_LANDING_PREVIEW_REFS`、`INVALID_HOME_CONFIG`、`VALIDATION_FAILED`、`PLAYWRIGHT_UNAVAILABLE`、`FILE_NOT_FOUND`、`USAGE`、`INTERNAL`。\n\n## 测试\n\n```bash\nnpm test\n# 等价于 node --test \"tests\u002F**\u002F*.test.mjs\"\n```\n\n测试全部使用临时目录，结束后清理，不产生工作空间残留。\n\n## 目录结构\n\n```text\npackages\u002Fskill-alipay-home\u002F\n├─ package.json\n├─ SKILL.md\n├─ manifest.json\n├─ bin\u002F\n│  └─ home-design.mjs       # CLI + 配置派生 + 组装编排（写 home-config.json 与 configuration-guide.md）\n├─ runtime\u002F\n│  ├─ planner.mjs           # DesignBrief 校验 + 文本\u002F图片规划 + deriveHomeConfig\n│  └─ asset-requester.mjs   # AssetRequest 合法性校验\n└─ tests\u002F\n   └─ home.test.mjs         # node:test\n```\n",{},"main","102972d3eb0ddf9d4a1be452077faf89f146d202","packages\u002Fskill-alipay-home","https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite","https:\u002F\u002Fgithub.com\u002FMadebyNight","2026-09-22 16:34:52",{"source":7,"skillName":5,"commands":29,"prompt":39,"zipAvailable":40},[30,33,36],{"tool":31,"command":32},"npx","npx skills add MadebyNight\u002Fdesign-skills-suite --skill skill-alipay-home",{"tool":34,"command":35},"bunx","bunx skills add MadebyNight\u002Fdesign-skills-suite --skill skill-alipay-home",{"tool":37,"command":38},"pnpm","pnpm dlx skills add MadebyNight\u002Fdesign-skills-suite --skill skill-alipay-home","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-alipay-home\u002FSKILL.md",true,[42,48,54,58,62,66],{"path":43,"resourceType":44,"resourceTypeDesc":45,"sizeBytes":46,"sourceHtmlUrl":47},"bin\u002Fhome-design.mjs","SCRIPT","脚本",32801,"https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-alipay-home\u002Fbin\u002Fhome-design.mjs",{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"manifest.json","REFERENCE","参考文档",605,"https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-alipay-home\u002Fmanifest.json",{"path":55,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":56,"sourceHtmlUrl":57},"package.json",403,"https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-alipay-home\u002Fpackage.json",{"path":59,"resourceType":44,"resourceTypeDesc":45,"sizeBytes":60,"sourceHtmlUrl":61},"runtime\u002Fasset-requester.mjs",2720,"https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-alipay-home\u002Fruntime\u002Fasset-requester.mjs",{"path":63,"resourceType":44,"resourceTypeDesc":45,"sizeBytes":64,"sourceHtmlUrl":65},"runtime\u002Fplanner.mjs",33995,"https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-alipay-home\u002Fruntime\u002Fplanner.mjs",{"path":67,"resourceType":44,"resourceTypeDesc":45,"sizeBytes":68,"sourceHtmlUrl":69},"tests\u002Fhome.test.mjs",65122,"https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-alipay-home\u002Ftests\u002Fhome.test.mjs",[71,77,83,89,95],{"skillNo":72,"name":73,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M7C2GXXVD602FKA28QWZW4JT","mock-image-edit","https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite\u002Fblob\u002Fmain\u002Ftest-fixtures\u002Fdesign-skills\u002Fmocks\u002Fmock-image-edit\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":18},"01M7C2GTSCKA00DJB9B7JPRJ6R","skill-orchestrator","https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-orchestrator\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M7C2GPT28KFVD8X2HHYVGJKK","skill-image-generate","https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-image-generate\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":18},"01M7C2GK0B9W95VGPJJPPBE88C","skill-alipay-landing","https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite\u002Fblob\u002Fmain\u002Fpackages\u002Fskill-alipay-landing\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":18},"01M7C2G9HHY8XZPYX6ZMBY6MA8","openphoto","Use for deterministic local image editing with OpenPhoto: inspect an image, crop or transform the canvas or an object, adjust image properties, apply supported filters, run automatic background removal\u002Fdepth\u002Fdetection\u002Fcoordinate segmentation\u002Fupscale, and return PNG or JPEG artifacts. Ask the user before downloading a missing AI model.","https:\u002F\u002Fgithub.com\u002FMadebyNight\u002Fdesign-skills-suite\u002Fblob\u002Fmain\u002Fpackages\u002Fopenphoto\u002Fskill\u002Fopenphoto\u002FSKILL.md",[],[]]