[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AA4Z2WA7B7GJZQ39BFPESH":3,"skill-same:01M7AA4Z2WA7B7GJZQ39BFPESH":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7AA4Z2WA7B7GJZQ39BFPESH","measure-before-hardcode",null,"业务开发中遇到任何由外部系统\u002F第三方决定、会随时间变化的数据（状态、数值、配置、接口返回结构、权限策略、资源限制、价格、版本等）时，必须先实测拿到正确值再写入，禁止凭猜写死静态默认值；并保持代码简洁可维护。接入第三方、处理外部数据、或要把某个值写进代码前启动。","Shaun520\u002Fquota-flow","Shaun520","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F183258186?v=4","01M7AA4SS47CCX42ZZ3JGP40PD","诗仙、","01M7AA4SSS52BTJM1B2Y3J312Z",53,"MIT","https:\u002F\u002Fgithub.com\u002FShaun520\u002Fquota-flow\u002Fblob\u002Fmain\u002Fskills\u002Fmeasure-before-hardcode\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: \"measure-before-hardcode\"\ndescription: \"业务开发中遇到任何由外部系统\u002F第三方决定、会随时间变化的数据（状态、数值、配置、接口返回结构、权限策略、资源限制、价格、版本等）时，必须先实测拿到正确值再写入，禁止凭猜写死静态默认值；并保持代码简洁可维护。接入第三方、处理外部数据、或要把某个值写进代码前启动。\"\n---\n\n# Measure Before Hardcode（实测再写，不靠猜）\n\n处理任何**由外部系统\u002F第三方依赖决定、且会随时间、环境或账号变化**的动态数据时，遵循本准则。这类数据无法靠推断得出，只能**实测**。\n\n这类数据的共同特征：来源不归你控制（第三方接口、平台页面、外部服务、远端 API），返回内容可能演进（新增\u002F改名、改签名、改取值范围、分页行为变化），且往往因**账号、地域、时间、套餐**而异。\n\n适用范围包括（但不限于）：\n\n- **厂商\u002F平台侧**：额度、余额、剩余量、总限额、限流阈值、开通\u002F激活状态、价格\u002F计费。\n- **接口\u002F数据侧**：第三方接口的返回结构、字段名、类型、状态码\u002F错误码枚举、分页约定、响应样例。\n- **配置\u002F策略侧**：远程配置、下发策略、权限点、功能开关、版本号、能力清单、枚举字典。\n- **资源\u002F限制侧**：文件\u002F内存\u002F网络上限、超时值、批量上限、硬件能力。\n\n## 核心规则\n\n1. **先实测，再写入**\n   - 动态数据的正确值只能来自**真实拉取\u002F真实接口响应\u002F真实页面抓取**。先实际调用或抓取，确认拿到正确数据后，才允许体现在代码里。\n   - 禁止在代码里填**猜测或脑补的静态默认值**。猜错会写错，还会误导依赖它的逻辑（例如\"以为有额度 → 放行生成 → 意外扣费\"；\"写死字段路径 → 接口改结构 → 运行时报错\"）。\n   - 测试\u002F临时用值一律标注 `\u002F\u002F TEMP: 实测后移除`，联调阶段替换为实测逻辑，勿带入线上。\n\n2. **运行时优先，抓不到即「未知」**\n   - 动态数据默认走**运行时获取**（接口\u002F页面抓取\u002F远端读取），代码只保留**稳定的元数据**（id、名称、能力、固定枚举、固定路径结构）。\n   - 运行时取不到时，显式标记为「未知\u002F不可确认」（如把数值定义成可空 `number | null`），并走**保守分支**：UI 显示占位符、高风险操作拦截、引导用户刷新\u002F重试。**绝不借用假值冒充真实值**，绝不因此放行可能造成损失的操作。\n\n3. **简洁，正确，可维护**\n   - 不为\"可能未来变化\"预置猜测常量；不为猜测值堆冗余注释、重复代码或层层兼容补丁。\n   - 常量\u002F目录\u002F配置只声明**稳定**内容，动态值一律由实测层作为**单一数据源**写入，避免多处硬编码相同值、改一处漏一处。\n   - 每处改动先验证（构建\u002F类型检查\u002F真实运行）通过再保留；发现猜错立即移除，不留\"先用着以后改\"的过渡性代码。宁缺毋滥——能简洁就简洁。\n\n## 常规流程\n\n1. **识别**：判断数据是否「外部动态数据」（非代码内部生成、可能因外部而变化）→ 是则默认走实测，不落常量。\n2. **实测**：调用真实接口\u002F抓取真实页面\u002F读真实远端，确定**返回结构与正确值范围**；记录来源（哪个接口\u002F哪个字段\u002F哪个页面）。\n3. **建模**：结构体、字段、枚举按实测结果定义，字段命名与来源一一对应，来源留痕。\n4. **未知处理**：定义「未知」语义（如 `remaining === null` \u002F `{ available: false }`），UI 与业务都走保守分支，不崩溃、不误导。\n5. **验证**：构建 + 类型检查 + 至少一次真实运行确认无回归。\n6. **清理**：移除测试期临时值、猜测常量与冗余注释，交付最小正确实现。\n\n## 反例 → 正例\n\n### 场景1：厂商额度（已落地）\n- ❌ 在适配器写死 `freeQuota: { remaining: 272120, total: 2000000 }`（历史旧值）。平台一改额度就失真；假余额放行生成 → 额度耗尽时错误扣费。\n- ✅ 目录只声明元数据 `{ id, name, modes }`，额度由实测接口（如 `ListModelTokenLimit`）抓取后写入；抓不到则 `remaining` 为「未知」，前端显示 `—`、生成前保守拦截。\n\n### 场景2：第三方接口返回结构\n- ❌ 假设接口固定：`const d = JSON.parse(resp).result.data[0].name`。接口新增嵌套层级\u002F字段改名后直接报错。\n- ✅ 实测结构后防御式解析：`const data = resp?.result?.data ?? []`，再按实测字段读取，字段缺失不崩。\n\n### 场景3：远端状态\u002F枚举字典\n- ❌ 写死 `if (status === 1) 已开通`。平台新增状态码 `2` 后逻辑失效，用户数据被误判。\n- ✅ 动态映射：`const enabledSet = await fetchEnabledList(); if (enabledSet.has(status)) ...`，枚举从远端正源拉取，新增值不破坏判断。\n\n### 场景4：配置下发 \u002F 资源限制\n- ❌ 写死超时 `timeout = 30000` 或批量上限 `maxBatch = 50`（\"应该够用\"）。实际限制变化后超时\u002F超限。\n- ✅ 从远端配置接口实测读取（带默认兜底语义为「未知→保守」），或按实测到的真实上限适配；实测值变化时自动跟随。\n\n## 适用触发词\n\n接入第三方系统\u002F新厂商\u002F新接口、处理外部接口返回、要把某个外部值（数值\u002F状态\u002FURL\u002F字段名\u002F枚举\u002F配置）写进代码、调试\"数据不对\u002F显示假值\u002F接口报错\u002F间歇性异常\"、涉及扣费放行\u002F状态判定\u002F权限校验时，启动本 skill。","# Measure Before Hardcode（实测再写，不靠猜）\n\n处理任何**由外部系统\u002F第三方依赖决定、且会随时间、环境或账号变化**的动态数据时，遵循本准则。这类数据无法靠推断得出，只能**实测**。\n\n这类数据的共同特征：来源不归你控制（第三方接口、平台页面、外部服务、远端 API），返回内容可能演进（新增\u002F改名、改签名、改取值范围、分页行为变化），且往往因**账号、地域、时间、套餐**而异。\n\n适用范围包括（但不限于）：\n\n- **厂商\u002F平台侧**：额度、余额、剩余量、总限额、限流阈值、开通\u002F激活状态、价格\u002F计费。\n- **接口\u002F数据侧**：第三方接口的返回结构、字段名、类型、状态码\u002F错误码枚举、分页约定、响应样例。\n- **配置\u002F策略侧**：远程配置、下发策略、权限点、功能开关、版本号、能力清单、枚举字典。\n- **资源\u002F限制侧**：文件\u002F内存\u002F网络上限、超时值、批量上限、硬件能力。\n\n## 核心规则\n\n1. **先实测，再写入**\n   - 动态数据的正确值只能来自**真实拉取\u002F真实接口响应\u002F真实页面抓取**。先实际调用或抓取，确认拿到正确数据后，才允许体现在代码里。\n   - 禁止在代码里填**猜测或脑补的静态默认值**。猜错会写错，还会误导依赖它的逻辑（例如\"以为有额度 → 放行生成 → 意外扣费\"；\"写死字段路径 → 接口改结构 → 运行时报错\"）。\n   - 测试\u002F临时用值一律标注 `\u002F\u002F TEMP: 实测后移除`，联调阶段替换为实测逻辑，勿带入线上。\n\n2. **运行时优先，抓不到即「未知」**\n   - 动态数据默认走**运行时获取**（接口\u002F页面抓取\u002F远端读取），代码只保留**稳定的元数据**（id、名称、能力、固定枚举、固定路径结构）。\n   - 运行时取不到时，显式标记为「未知\u002F不可确认」（如把数值定义成可空 `number | null`），并走**保守分支**：UI 显示占位符、高风险操作拦截、引导用户刷新\u002F重试。**绝不借用假值冒充真实值**，绝不因此放行可能造成损失的操作。\n\n3. **简洁，正确，可维护**\n   - 不为\"可能未来变化\"预置猜测常量；不为猜测值堆冗余注释、重复代码或层层兼容补丁。\n   - 常量\u002F目录\u002F配置只声明**稳定**内容，动态值一律由实测层作为**单一数据源**写入，避免多处硬编码相同值、改一处漏一处。\n   - 每处改动先验证（构建\u002F类型检查\u002F真实运行）通过再保留；发现猜错立即移除，不留\"先用着以后改\"的过渡性代码。宁缺毋滥——能简洁就简洁。\n\n## 常规流程\n\n1. **识别**：判断数据是否「外部动态数据」（非代码内部生成、可能因外部而变化）→ 是则默认走实测，不落常量。\n2. **实测**：调用真实接口\u002F抓取真实页面\u002F读真实远端，确定**返回结构与正确值范围**；记录来源（哪个接口\u002F哪个字段\u002F哪个页面）。\n3. **建模**：结构体、字段、枚举按实测结果定义，字段命名与来源一一对应，来源留痕。\n4. **未知处理**：定义「未知」语义（如 `remaining === null` \u002F `{ available: false }`），UI 与业务都走保守分支，不崩溃、不误导。\n5. **验证**：构建 + 类型检查 + 至少一次真实运行确认无回归。\n6. **清理**：移除测试期临时值、猜测常量与冗余注释，交付最小正确实现。\n\n## 反例 → 正例\n\n### 场景1：厂商额度（已落地）\n- ❌ 在适配器写死 `freeQuota: { remaining: 272120, total: 2000000 }`（历史旧值）。平台一改额度就失真；假余额放行生成 → 额度耗尽时错误扣费。\n- ✅ 目录只声明元数据 `{ id, name, modes }`，额度由实测接口（如 `ListModelTokenLimit`）抓取后写入；抓不到则 `remaining` 为「未知」，前端显示 `—`、生成前保守拦截。\n\n### 场景2：第三方接口返回结构\n- ❌ 假设接口固定：`const d = JSON.parse(resp).result.data[0].name`。接口新增嵌套层级\u002F字段改名后直接报错。\n- ✅ 实测结构后防御式解析：`const data = resp?.result?.data ?? []`，再按实测字段读取，字段缺失不崩。\n\n### 场景3：远端状态\u002F枚举字典\n- ❌ 写死 `if (status === 1) 已开通`。平台新增状态码 `2` 后逻辑失效，用户数据被误判。\n- ✅ 动态映射：`const enabledSet = await fetchEnabledList(); if (enabledSet.has(status)) ...`，枚举从远端正源拉取，新增值不破坏判断。\n\n### 场景4：配置下发 \u002F 资源限制\n- ❌ 写死超时 `timeout = 30000` 或批量上限 `maxBatch = 50`（\"应该够用\"）。实际限制变化后超时\u002F超限。\n- ✅ 从远端配置接口实测读取（带默认兜底语义为「未知→保守」），或按实测到的真实上限适配；实测值变化时自动跟随。\n\n## 适用触发词\n\n接入第三方系统\u002F新厂商\u002F新接口、处理外部接口返回、要把某个外部值（数值\u002F状态\u002FURL\u002F字段名\u002F枚举\u002F配置）写进代码、调试\"数据不对\u002F显示假值\u002F接口报错\u002F间歇性异常\"、涉及扣费放行\u002F状态判定\u002F权限校验时，启动本 skill。",{"name":5,"description":7},"main","7c044e6f426be9aaa2177b3e48cdc95376e6d8d2","skills\u002Fmeasure-before-hardcode",8,"https:\u002F\u002Fgithub.com\u002FShaun520\u002Fquota-flow","https:\u002F\u002Fquota-flow-admin.vercel.app","https:\u002F\u002Fgithub.com\u002FShaun520","Shaun","2026-09-14 19:50:17",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add Shaun520\u002Fquota-flow --skill measure-before-hardcode",{"tool":39,"command":40},"bunx","bunx skills add Shaun520\u002Fquota-flow --skill measure-before-hardcode",{"tool":42,"command":43},"pnpm","pnpm dlx skills add Shaun520\u002Fquota-flow --skill measure-before-hardcode","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FShaun520\u002Fquota-flow\u002Fblob\u002Fmain\u002Fskills\u002Fmeasure-before-hardcode\u002FSKILL.md",true,[],[48,55,62],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M7AA51J5MVVCFYXHVN2XXFRD","postgrest-egress-optimization","降低 Supabase\u002FPostgREST 出口流量(Egress)与请求量的排查落地方法论。用户反馈流量超额、请求数过高、查询慢、或要做数据库访问优化时调用。","https:\u002F\u002Fgithub.com\u002FShaun520\u002Fquota-flow\u002Fblob\u002Fmain\u002Fskills\u002Fpostgrest-egress-optimization\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M7AA4WDKDZ4B8GCMQDRZN9ZT","karpathy-guidelines","Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes, surface assumptions, and define verifiable success criteria.","https:\u002F\u002Fgithub.com\u002FShaun520\u002Fquota-flow\u002Fblob\u002Fmain\u002Fskills\u002Fkarpathy-guidelines\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7AA4V2ZKJJ2VX47CPKB1QX1","skill","https:\u002F\u002Fgithub.com\u002FShaun520\u002Fquota-flow\u002Fblob\u002Fmain\u002Fapps\u002Fskill\u002FSKILL.md",[],[]]