[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7APM4YSNXGCRE5F9RR5MAJB":3,"skill-same:01M7APM4YSNXGCRE5F9RR5MAJB":52},{"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":30,"commitSha":31,"skillDirectory":32,"forksCount":14,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":35,"ownerDescription":36,"updatedAt":37,"install":38,"resources":51},"01M7APM4YSNXGCRE5F9RR5MAJB","quality-gate",null,"开发完成后的自检门禁：愿景对照 + spec 合规 + 验证。 Use when: 准备对交付作完成声明、需要整理风险匹配的自证。 Not for: 收到 review 反馈（用 receive-review）、merge（用 merge-gate）。 Output: Spec 合规报告（含愿景覆盖度）。","peps1666\u002FBuildCrew-AI","peps1666","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F128503359?v=4","01M7APD9BQ6NTJ79J9FTB6YZGT","junhao zhou","01M7APD9CD06Q6CCJ22FYVG2AK",0,"MIT","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fquality-gate\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: quality-gate\ndescription: >\n  开发完成后的自检门禁：愿景对照 + spec 合规 + 验证。\n  Use when: 准备对交付作完成声明、需要整理风险匹配的自证。\n  Not for: 收到 review 反馈（用 receive-review）、merge（用 merge-gate）。\n  Output: Spec 合规报告（含愿景覆盖度）。\ntriggers:\n  - \"开发完了\"\n  - \"准备 review\"\n  - \"自检\"\n  - \"声称完成\"\n---\n\n> **SOP 位置**: 本 skill 是 `sop-definitions\u002Fdevelopment.yaml` stage `quality_gate` 的执行细节。\n> **SOP definition**: `sop-definitions\u002Fdevelopment.yaml` stage `quality_gate`。\n> 这是按需自检车道，不绑定固定上一步 \u002F 下一步；完成后把证据交给实际选择的独立验证源或交付载体。\n\n# Quality Gate\n\n完成声明前做两件事：对照真实需求自检，并用与风险面匹配的真实命令输出证明声明。\n\n## 核心知识\n\n**两条铁律合一**：\n\n1. **Spec alignment**（来自 `spec-compliance-check`）：AC 可能写偏，先回读原始需求，再逐项验收\n2. **Evidence before claims**（来自 `verification-before-completion`）：没有运行命令、没看到输出，就不能说\"通过了\"\n\n> 铁律：`NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE`\n>\n> 自问：\"我是这次真的运行了命令并看到输出，还是我只是相信它能工作？\"\n\n**为什么 AC 可能不够**：AC 是人写的，可能遗漏 UX 要求或场景覆盖。F041 教训：AC 全打勾，但operator的原始需求（能力显示描述、多项目管理）根本没进 AC——spec compliance check 检查了 AC，但 AC 本身就是错的。\n\n## 流程\n\n```\nBEFORE 声称完成 \u002F 提 review:\n\nStep 0: VISION CHECK（愿景核对）\n  ① 找原始 Discussion\u002FInterview 文档（operator experience在里面）\n  ② 读核心痛点：\"我要...\"、\"我不想...\"\n  ③ 问自己：operator坐在 Hub 前用这个功能，体验是什么样的？\n  ④ AC 是否完整覆盖了operator的原始需求？\n     → 如有遗漏，先补 AC 再继续\n\nStep 0.5: DELIVERY COMPLETENESS CHECK\n  ① 这次交付的是完整 feat 还是 feat 的一部分？\n     → 完整 feat：继续\n     → 部分：有operator明确同意分批交付的记录吗？没有就继续做完\n  ② 本次产出后续需要\"重写\"还是\"扩展\"？\n     → 扩展：通过\n     → 重写：如果是已标注 Spike 且有结论，通过；否则不通过，回去重做\n\nStep 1: FIND — 找 spec\u002Fplan 文档\n  - the active feature spec or implementation plan\n  - 同时找 Discussion\u002FInterview（operator experience所在）\n\nStep 2: CREATE — 建检查清单\n  - 列出每一个 AC \u002F 功能点 \u002F 边界条件\n  - 列出 Discussion 里的 UX 描述和场景\n\nStep 2.5: CLOSE GATE MATRIX + FOLLOW-UP TAIL SCAN（F177 Phase A）🔴\n  - 检查 CloseGateReport 是否已生成（schema: `cat-cafe-skills\u002Frefs\u002Fclose-gate.md`）\n  - 每个 unmet AC 是否三选一处置（immediate \u002F delete \u002F cvo_signoff）\n  - **Follow-up tail scan**：扫以下文本来源，命中关键词 = **线索（进入语义判定），不是自动 BLOCKED**——判定标准只有一条：该词是否在把 **unmet AC 包装成已完成 \u002F 偷偷延期**（close 借口）。正常阶段描述（\"X 属 next phase 的 scope\"）、风险讨论、路线图引用不触发（2026-07-15 修订：raw keyword 自动 BLOCK 误杀正常文本）：\n    - 来源：close report、PR body、commit messages、spec 中 AC 注释、review 反馈回复\n    - 线索关键词（不区分大小写；仅用于定位待语义检查处）：\n      `follow-up` `followup` `deferred` `next phase` `next PR` `P2` `stub` `TD`\n      `后续` `留个尾巴` `先这样` `下次一定` `回头` `以后再` `will address later`\n      `out of scope`（作为 close 借口时）`MVP 先上`（作为 close 借口时）\n    - 豁免：spec 的 Why\u002FRisk\u002FHistory 章节中引用历史上下文时使用这些词不触发\n  - cvo_signoff 四件套完整性验证（proposal + cvo message + quote + scope）\n  - 🔴 **47 盲审规则**（F177 Phase B）：若 PR 作者是 opus-47，quality-gate 必须由对家猫执行（Maine Coon优先，46 兜底）。审核者由 reviewer\u002F系统指定，47 无选择权，47 的自评不计入放行判据\n  - 🔴 **hotfix 自检禁止**（F177 Phase E）：执行 `node scripts\u002Fcheck-hotfix-pattern.mjs`，若检测到 hotfix 模式，作者不得自行通过 quality-gate——必须由另一只猫执行 quality-gate。原因：hotfix 心态容易自我说服\"够用了\"，跨猫审视打破惯性\n  - 🔴 **Ragdoll search→Read 检查**（F177 Phase F）：若执行者是Ragdoll家族（46 \u002F 47 \u002F 4.5 \u002F Sonnet），检查本次 session 的 search 行为：\n    1. 有 `search_evidence` 调用命中 doc anchor（高\u002F中置信度）吗？\n    2. 命中后有对应的 `Read` 调用去读源文件吗？\n    3. 输出中包含精确数字\u002F版本号\u002F日期但没有 Read 证据吗？\n    → 三条件同时满足 = **BLOCKED**：\"这个精确结论你 Read 源文件了吗？摘要是索引不是答案。\"\n    → 豁免：架构方案\u002F假设性讨论（不含精确数字的推理不触发）；通过 Grep\u002FLSP 获取的精确信息不触发\n  - 🔴 **Siamese edit scope 检查**（F177 Phase C）：若 PR 作者是Siamese，检查改动文件是否超出白名单（designs\u002F docs\u002F assets\u002F 根目录.md）。碰 packages\u002F src\u002F 的改动必须有对应 handoff 记录或 Dry Run Gate 通过证据（build + test pass）\n\nStep 2.6: FALLBACK LAYER CHECK（F177 Phase D）🔴\n  - 执行：`node scripts\u002Fcheck-fallback-layers.mjs` 扫描 PR diff\n  - 同一文件新增 ≥3 层 fallback 或累计 ≥5 层 → 触发坐标系自检\n  - 自检三问：①修坐标系还是补错误坐标系？②坐标变换能否消除？③每层为什么不能去掉？\n  - 层数合理时在报告中说明理由；不合理时重构后再过 gate\n\nStep 2.7: ARCHITECTURE OWNERSHIP REPORT（F191，warning-only）🔴\n  - 执行：`pnpm check:architecture-ownership`\n  - 从 spec \u002F plan 抄入：\n    `Architecture cell` \u002F `Map delta` \u002F `Why`\n  - 若缺失，报告 `⚠️ missing` 并列为 review focus；不在 quality-gate 做 semantic hard block\n  - 若 `Map delta: none` 但 diff 明显新增 `Store|Queue|Router|Adapter|Dispatcher|Binding` 等架构名词，报告 mismatch 给 reviewer\n  - 若 `Map delta: update required|new cell required`，报告对应 ownership cell \u002F new cell 文件是否随 PR 更新\n  - 注意：quality-gate 只报告机械可见事实；架构语义正确性由 Design Gate + reviewer 判断\n\nStep 3: VERIFY — 逐项检查\n  - 代码在哪？有测试覆盖？边界处理了？\n  - 🔴 F244 Tips Contribution：若本 PR 新增\u002F修改 user-visible feature \u002F capability \u002F guide \u002F harness behavior，\n    必须满足其一：\n    ① `packages\u002Fweb\u002Fsrc\u002Flib\u002Fcapability-tips.seed.json` 有对应 `sourceRef` tip\n    ② 相关 feature\u002Fguide\u002Fskill 文件写明 `tips_exempt: {reason}`\n    并执行 `pnpm check:capability-tips`。\n    注意：CI 只证明结构\u002Fanchor\u002Faction；reviewer 仍要退回只复述标题、没有动作或时机的废话 tip。\n  - 🔴 交付物必须核实 commit\u002FPR 状态（git log --grep + gh pr list）\n    spec checkbox 是记录工具，不是真相源（LL-029）\n  - 🔴 新增 MCP 工具 → 认知入口更新了吗？优先级：MCP tool description → 相关 skill refs → capability wakeup \u002F L0 quick index；只有 legacy\u002Ffallback surface 仍依赖时才补 `MCP_TOOLS_SECTION`（F086 教训：造了工具猫不知道；F203 后不再默认塞 SystemPromptBuilder）\n  - 🔴 新增行为规则 → governance digest \u002F shared-rules 注入更新了吗？\n  - 🔴 产出了 SKILL.md 或改了 MCP tool description → 加载 `writing-skills`，用 T0 六要素审查质量（软硬同检）\n\nStep 4: RUNTIME GUARD — 前端证据采集前先做运行态保护\n  - 若会话在 `cat-cafe-runtime`，先探活：`curl -sf http:\u002F\u002Flocalhost:3004\u002Fhealth`\n  - 服务已在线时直接复用，禁止在该会话执行 `pnpm start` \u002F `pnpm runtime:start` \u002F `.\u002Fscripts\u002Fstart-dev.sh`\n  - `localhost:3003\u002F3004` 默认按 runtime 处理；如果你要验证未合入改动，不能把这两个端口的页面\u002F接口响应当成当前分支的证据\n  - 证明“这是我当前 worktree 的验证证据”时，必须同时说清：`worktree\u002Fcwd` + 目标 URL。两者对不上 = 证据无效\n  - 确需重启时，先获operator明确授权，再用 `CAT_CAFE_RUNTIME_RESTART_OK=1` 执行\n  - **Alpha 优先**：验证已合入 main 的改动时，优先用 `pnpm alpha:start`（3011\u002F3012\u002F4111\u002F6398）取证，而非 runtime。Alpha 环境每次启动自动同步 origin\u002Fmain\n\nStep 4.5: DOGFOOD-YOUR-SLICE — 用一次自己刚做的功能（F209 教训 2026-05-23）🔴\n  对 user-visible \u002F runtime feature，author 必须在请求 review 前：\n    ① 跑一条**真实端到端 query \u002F 路径**，涵盖该 slice 的核心交付能力\n    ② 把命令 + 输出 \u002F 截图证据写进 Quality Gate Report 的 \"Dogfood\" 块\n    ③ 抓到的任何 dogfood bug 必须当轮修，不允许\"post-merge 再说\"\n    ④ **结构性例外**（2026-07-15）：验证路径只在合入后才存在（需 main\u002Falpha 环境或真实外部案例，AC-F7 型）→ pre-merge 验证到能验的边界即可，剩余由**带 owner + 触发条件的持久 post-merge task** 接走，**不阻塞 pre-merge review \u002F merge**；若它是 required AC，则 task 在 terminal PASS（或 `delete` \u002F `cvo_signoff`）前仍阻塞 **feature close**。例外理由写进 review packet\n\n  Scope（必做 vs 可豁免）：\n    - **必做**：任何对最终用户 \u002F 猫体感有变化的 feature 或 bugfix。包括但不限于：\n      search \u002F recall \u002F UI \u002F routing \u002F drillDown \u002F typed reader \u002F 任何新 MCP tool \u002F 任何新 REST 端点 \u002F\n      **任何修复用户或猫可感知路径的 bugfix（即使已有回归测试覆盖）**\n      → 反例 PR #1854 dogfood hotfix：file-slice drillDown 路径口径不一致，已有回归测试也不够——\n        必须 author 自己跑一遍 `search_evidence → drillDown → read_file_slice` 才能抓到\n    - **可豁免**：docs-only \u002F 纯重构 \u002F 纯测试 \u002F 内部基础设施 \u002F **纯内部 bugfix（非 user\u002Fcat 可感知路径，如内部 DB 一致性、log format、纯算法常量调整等）**\n      → 豁免必须**显式在 review packet 里写出理由**（\"docs-only\" \u002F \"纯重构 + 既有测试覆盖\" \u002F \"纯内部 bugfix，不影响 user\u002Fcat 可感知路径\"等），不能省略\n\n  Why（F209 反思 2026-05-23）:\n    \"AC pass 但用户感受不到\" + \"dogfood bug post-merge 才暴露\" 是同型走偏。\n    - Phase B alias registry: AC-B1~B5 全 ✅、跨族 review APPROVE、merge 闭环 — 但生产 `entity_registry` 是空的，真实用户搜 `operator` 找不到 `operator`。\n    - Phase C drillDown: 测试 \u002F cloud review \u002F merge 都过 — 但 author 自己 post-merge 用一次刚发现 file-slice 路径口径不一致。\n    根因是没人 pre-review 真用一次自己刚做的东西。pre-merge dogfood 把这一类 bug 提前到 author 自检阶段。\n\n  报告写法（在 Quality Gate Report 里加 \"### Dogfood\" 块）：\n    ```markdown\n    ### Dogfood-Your-Slice\n    Scope verdict: ✅ 必做 \u002F 🆗 可豁免（理由：xxx）\n\n    （必做时）\n    端到端路径: search_evidence(\"operator\") → drillDown → cat_cafe_get_thread_context\n    实际命令 \u002F 输出（粘贴）: ...\n    发现的 bug: 无 \u002F 列表（含修复 commit SHA）\n    ```\n\nStep 5: PEN CHECK — 自动化设计稿对照（不可跳过！）\n  ① glob designs\u002F**\u002F*.pen，匹配当前 feat 编号或关键词\n  ② 若匹配到 .pen 文件 → 强制进入设计稿对照流程（见下方\"有 .pen 设计稿的功能额外要求\"）\n  ③ 若无匹配 → 检查 feat 是否有前端 UI 改动（改了 packages\u002Fweb\u002Fsrc\u002Fcomponents\u002F）\n     → 有 UI 改动但无 .pen → 在报告中标注\"⚠️ 无设计稿，跳过对照\"\n  ④ 此步骤不依赖猫猫\"记得\"——必须执行 glob 命令，用输出决定是否进入对照\n\nStep 6: RUN — 运行风险匹配的验证命令（必须这次真实运行）\n  ① 先列五轴风险与受影响面；命令逐条对应 claim，不按“写了代码”机械全跑\n  ② 默认：受影响 package \u002F schema \u002F generator \u002F docs checker + git diff --check\n  ③ 新行为 \u002F bug：相关行为或回归测试；现有精确检查红可以直接作 RED\n  ④ 安全、鉴权、生产数据、迁移、外部契约、不可逆，或 targeted 无法覆盖跨包合流风险：pnpm gate\n  ⑤ Redis 相关改动额外跑：pnpm --filter @cat-cafe\u002Fapi test:redis（只连 6398）\n  ⑥ 任一实际选择的检查红都先修；不得挑绿灯报告、隐去红灯\n\nStep 7: READ — 完整读输出，看 exit code，数失败数\n\nStep 7.5: ARTIFACT HYGIENE CHECK — 根目录媒体垃圾闸门\n  - 执行（工作树）：\n    `git status --short | rg '^.. [^\u002F]+\\.(png|jpe?g|webp|gif|webm|mp4|mov|wav|pdf|pen)$'`\n  - 执行（已提交差异）：\n    `git diff --name-only origin\u002Fmain...HEAD | rg '^[^\u002F]+\\.(png|jpe?g|webp|gif|webm|mp4|mov|wav|pdf|pen)$'`\n  - 任一命中 → BLOCK：说明仓库根目录出现了媒体\u002F设计工件（含已跟踪和未跟踪）\n  - 处理方式：移到 `${TMPDIR}\u002Fcat-cafe-evidence\u002F...` 或显式归档到正式目录后再继续\n  - 规则真相源：`cat-cafe-skills\u002Frefs\u002Fevidence-output-contract.md`\n\nStep 8: REPORT — 输出合规报告 + 证据\n```\n\n**前端功能额外要求**：author 必须在正确 worktree \u002F preview 上走关键交互，并记录 URL、操作与结果。截图、录屏、DOM assertion、Playwright 输出都是证据载体；只有视觉判断确实需要画面时才采截图 \u002F 录屏，缺截图本身不阻塞，也不得让 operator 代采。执行细则：`cat-cafe-skills\u002Frefs\u002Fvision-evidence-workflow.md`。\n\n**有 .pen 设计稿的功能额外要求** 🔴（Step 5 匹配到 .pen 时强制执行）：\n1. 打开 .pen 文件 → `get_screenshot` 截取设计稿\n2. Playwright\u002FChrome 打开实际页面 → 截取实现截图\n3. 逐区域对比：布局、颜色、间距、交互状态\n4. 不一致处必须标注并修复（或记录为\"有意偏差 + 原因\"）\n5. 报告附 **设计稿截图 vs 实现截图** 对照表\n6. 🔴 **此流程由 Step 5 自动触发，不依赖猫猫主动想起来**\n\n> 教训（2026-03-11）：三只Ragdoll同时跳过了 .pen 对照，根因是没有自动化检查点。\n> Step 5 的 glob 就是解决这个问题——用命令输出驱动，不靠记忆。\n\n## Quick Reference\n\n| Claim | 需要 | 不够用 |\n|-------|------|--------|\n| 测试通过 | 这次运行输出：0 failures | \"上次跑过\"、\"应该通过\" |\n| targeted checks 通过 | 与改动面对应的本轮命令 + exit 0 | 只挑一盏绿灯、隐去相关红灯 |\n| full gate 通过 | high 风险触发时本轮 `pnpm gate` exit 0 | 低风险为了报告完整机械全跑，或高风险只跑局部 |\n| Bug 修了 | 原症状测试：通过 | 代码改了，以为修了 |\n| 需求满足 | spec + Discussion 逐项打勾 | 测试通过就完事 |\n| Feature 完成\u002F未完成 | git log + PR 状态 + spec 逐项 | 只看 spec checkbox 就下结论 |\n\n**合规报告模板**：\n\n```markdown\n## Quality Gate Report\n\nSpec: feature spec or implementation note\n原始需求: feature-discussions\u002FYYYY-MM-DD-xxx\u002FREADME.md\n检查时间: YYYY-MM-DD HH:MM\n\n### 愿景覆盖（Step 0）\n| # | operator原始需求 | AC 覆盖？ | 实现？ |\n|---|---------------|-----------|--------|\n| 1 | \"我要 XXX\"    | AC#3      | ✅     |\n\n### 功能验收\n| # | 要求 | 状态 | 代码位置 | 测试覆盖 |\n|---|------|------|----------|----------|\n| 1 | XXX  | ✅   | file.ts:L10 | test.spec.ts |\n\n### 设计稿对照（Step 5）\nglob designs\u002F**\u002F*.pen 匹配结果: [列出匹配文件或\"无匹配\"]\n对照状态: ✅ 已对照 \u002F ⚠️ 无设计稿（有 UI 改动）\u002F ➖ 无 UI 改动\n\n### Artifact Hygiene（Step 7.5）\n仓库根目录媒体\u002F设计工件（工作树 + 已提交差异）: 无 ✅\n\n### Architecture Ownership（Step 2.7）\nArchitecture cell: dispatch\nMap delta: none\nWhy: 只扩展现有 InvocationQueue 行为，不改变 dispatch cell 边界\nDiff mismatch scan: 无新增并行 Store\u002FQueue\u002FRouter\u002FAdapter ✅\n\n### Dogfood-Your-Slice（Step 4.5）\nScope verdict: ✅ 必做 \u002F 🆗 可豁免（理由）\n（必做时）端到端路径: search_evidence(\"...\") → drillDown → reader(...)\n实际命令 \u002F 输出 \u002F 截图: ...\n发现的 bug: 无 \u002F 列表（含修复 commit SHA）\n\n### 五轴风险与验证命令（必须是这次真实运行）\n风险: behavior=\u003C...> data=\u003C...> security=\u003C...> contract=\u003C...> irreversible=\u003C...>\n\u003Ctargeted command 1> → exit 0 ✅（覆盖 claim: ...）\n\u003Ctargeted command 2> → exit 0 ✅（覆盖 claim: ...）\npnpm gate → exit 0 ✅（仅 high 风险实际触发时填写）\n```\n\n## Common Mistakes\n\n| 错误 | 正确做法 |\n|------|----------|\n| 只检查 AC，没回读 Discussion | Step 0 先读原始需求，AC 可能不完整 |\n| \"上次跑测试是通过的\" | 这次重新跑，看输出，再声明 |\n| \"应该没问题\" \u002F \"probably works\" | Run the command. Read the output. |\n| 测试通过就声称 phase 完成 | 还要对照 spec 逐项检查 |\n| 部分实现就提 review | P1\u002FP2 遗漏必须当轮补完再提 review |\n| 交付半成品让operator\"先看看\" | 交付完整 feat，步骤是内部节奏不是交付批次 |\n| 产出后续要重写而非扩展 | 如果要重写，说明绕路了（Spike 除外） |\n| author 没跑 frontend preview，把“缺截图”扔给 operator | author 走关键交互；按视觉风险选择截图 \u002F 录屏 \u002F DOM \u002F 浏览器测试证据 |\n| 有 .pen 设计稿但没对照实现 | Step 5 自动 glob 检测，匹配到就强制对照，不靠记忆 |\n| 为了截图在 runtime 会话里重跑 `pnpm start` | 先探活复用现有 runtime；确需重启必须显式授权 |\n| 拿 runtime 的 `3003\u002F3004` 页面当成当前 worktree 的验证结果 | 报告里同时写明 `pwd\u002Fworktree` 和目标 URL；如果 URL 是 `3003\u002F3004`，默认这是 runtime 证据，不是未合入改动证据 |\n| 截图\u002F录屏\u002F设计稿顺手掉进仓库根目录 | Step 7.5 必查；先移到 `${TMPDIR}\u002Fcat-cafe-evidence\u002F...` 或正式归档目录，再继续 |\n| Redis 改动用默认测试命令 | 必须跑 `test:redis`，禁止直连 6399 |\n| 产出了 skill\u002FMCP 但没审查质量 | 加载 `writing-skills`，用 T0 六要素审查（软硬同检） |\n| 只看 spec checkbox 就声称完成\u002F未完成 | 核实 `git log --grep` + `gh pr list` + 实际 commit（LL-029）|\n| AC 全 ✅ 就声明 phase close（机制 ship 但用户感受不到）| Step 4.5 Dogfood-Your-Slice：必做 feature 跑一条真实端到端 query 写进报告；豁免必须显式写理由（F209 反思 2026-05-23）|\n\n**Red flags — 立刻 STOP**：\n- 用 \"should\"、\"probably\"、\"seems to\"\n- 表达满足感（\"好了！\"、\"完成！\"）时还没运行命令\n- 信任 subagent 的 \"success\" 报告而没独立验证\n\n## 和其他 skill 的区别\n\n| Skill | 关注点 | 时机 |\n|-------|--------|------|\n| **quality-gate（本 skill）** | spec 对照 + 风险匹配证据 | 作完成声明之前 |\n| `merge-gate` | reviewer 是否放行、P1\u002FP2 是否全修 | 合入 main 之前 |\n| `receive-review` | 如何处理 reviewer 的反馈 | 收到 review 之后 |\n\n一句话：quality-gate 是\"你自己检查自己\"，merge-gate 是\"reviewer 放行你\"，receive-review 是\"你处理 reviewer 的意见\"。\n\n## 下一步\n\nQuality Gate 通过后，把证据交给风险路由已选择的独立验证源：治理 \u002F stateful 语义通常走 `request-review`；安全 \u002F 契约的 context-blind 扫描可走 cloud；`fresh-context-review` 仅在 author 判断认知盲点收益足够时作为 finding generator，不是固定前置。\n\nGate 未通过时：\n- **P1 遗漏** → 补完再过 gate\n- **P2 遗漏** → 必须当轮补完再提 review\n- **已选择的 targeted \u002F full 检查失败** → 修到绿灯再交付\n","> **SOP 位置**: 本 skill 是 `sop-definitions\u002Fdevelopment.yaml` stage `quality_gate` 的执行细节。\n> **SOP definition**: `sop-definitions\u002Fdevelopment.yaml` stage `quality_gate`。\n> 这是按需自检车道，不绑定固定上一步 \u002F 下一步；完成后把证据交给实际选择的独立验证源或交付载体。\n\n# Quality Gate\n\n完成声明前做两件事：对照真实需求自检，并用与风险面匹配的真实命令输出证明声明。\n\n## 核心知识\n\n**两条铁律合一**：\n\n1. **Spec alignment**（来自 `spec-compliance-check`）：AC 可能写偏，先回读原始需求，再逐项验收\n2. **Evidence before claims**（来自 `verification-before-completion`）：没有运行命令、没看到输出，就不能说\"通过了\"\n\n> 铁律：`NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE`\n>\n> 自问：\"我是这次真的运行了命令并看到输出，还是我只是相信它能工作？\"\n\n**为什么 AC 可能不够**：AC 是人写的，可能遗漏 UX 要求或场景覆盖。F041 教训：AC 全打勾，但operator的原始需求（能力显示描述、多项目管理）根本没进 AC——spec compliance check 检查了 AC，但 AC 本身就是错的。\n\n## 流程\n\n```\nBEFORE 声称完成 \u002F 提 review:\n\nStep 0: VISION CHECK（愿景核对）\n  ① 找原始 Discussion\u002FInterview 文档（operator experience在里面）\n  ② 读核心痛点：\"我要...\"、\"我不想...\"\n  ③ 问自己：operator坐在 Hub 前用这个功能，体验是什么样的？\n  ④ AC 是否完整覆盖了operator的原始需求？\n     → 如有遗漏，先补 AC 再继续\n\nStep 0.5: DELIVERY COMPLETENESS CHECK\n  ① 这次交付的是完整 feat 还是 feat 的一部分？\n     → 完整 feat：继续\n     → 部分：有operator明确同意分批交付的记录吗？没有就继续做完\n  ② 本次产出后续需要\"重写\"还是\"扩展\"？\n     → 扩展：通过\n     → 重写：如果是已标注 Spike 且有结论，通过；否则不通过，回去重做\n\nStep 1: FIND — 找 spec\u002Fplan 文档\n  - the active feature spec or implementation plan\n  - 同时找 Discussion\u002FInterview（operator experience所在）\n\nStep 2: CREATE — 建检查清单\n  - 列出每一个 AC \u002F 功能点 \u002F 边界条件\n  - 列出 Discussion 里的 UX 描述和场景\n\nStep 2.5: CLOSE GATE MATRIX + FOLLOW-UP TAIL SCAN（F177 Phase A）🔴\n  - 检查 CloseGateReport 是否已生成（schema: `cat-cafe-skills\u002Frefs\u002Fclose-gate.md`）\n  - 每个 unmet AC 是否三选一处置（immediate \u002F delete \u002F cvo_signoff）\n  - **Follow-up tail scan**：扫以下文本来源，命中关键词 = **线索（进入语义判定），不是自动 BLOCKED**——判定标准只有一条：该词是否在把 **unmet AC 包装成已完成 \u002F 偷偷延期**（close 借口）。正常阶段描述（\"X 属 next phase 的 scope\"）、风险讨论、路线图引用不触发（2026-07-15 修订：raw keyword 自动 BLOCK 误杀正常文本）：\n    - 来源：close report、PR body、commit messages、spec 中 AC 注释、review 反馈回复\n    - 线索关键词（不区分大小写；仅用于定位待语义检查处）：\n      `follow-up` `followup` `deferred` `next phase` `next PR` `P2` `stub` `TD`\n      `后续` `留个尾巴` `先这样` `下次一定` `回头` `以后再` `will address later`\n      `out of scope`（作为 close 借口时）`MVP 先上`（作为 close 借口时）\n    - 豁免：spec 的 Why\u002FRisk\u002FHistory 章节中引用历史上下文时使用这些词不触发\n  - cvo_signoff 四件套完整性验证（proposal + cvo message + quote + scope）\n  - 🔴 **47 盲审规则**（F177 Phase B）：若 PR 作者是 opus-47，quality-gate 必须由对家猫执行（Maine Coon优先，46 兜底）。审核者由 reviewer\u002F系统指定，47 无选择权，47 的自评不计入放行判据\n  - 🔴 **hotfix 自检禁止**（F177 Phase E）：执行 `node scripts\u002Fcheck-hotfix-pattern.mjs`，若检测到 hotfix 模式，作者不得自行通过 quality-gate——必须由另一只猫执行 quality-gate。原因：hotfix 心态容易自我说服\"够用了\"，跨猫审视打破惯性\n  - 🔴 **Ragdoll search→Read 检查**（F177 Phase F）：若执行者是Ragdoll家族（46 \u002F 47 \u002F 4.5 \u002F Sonnet），检查本次 session 的 search 行为：\n    1. 有 `search_evidence` 调用命中 doc anchor（高\u002F中置信度）吗？\n    2. 命中后有对应的 `Read` 调用去读源文件吗？\n    3. 输出中包含精确数字\u002F版本号\u002F日期但没有 Read 证据吗？\n    → 三条件同时满足 = **BLOCKED**：\"这个精确结论你 Read 源文件了吗？摘要是索引不是答案。\"\n    → 豁免：架构方案\u002F假设性讨论（不含精确数字的推理不触发）；通过 Grep\u002FLSP 获取的精确信息不触发\n  - 🔴 **Siamese edit scope 检查**（F177 Phase C）：若 PR 作者是Siamese，检查改动文件是否超出白名单（designs\u002F docs\u002F assets\u002F 根目录.md）。碰 packages\u002F src\u002F 的改动必须有对应 handoff 记录或 Dry Run Gate 通过证据（build + test pass）\n\nStep 2.6: FALLBACK LAYER CHECK（F177 Phase D）🔴\n  - 执行：`node scripts\u002Fcheck-fallback-layers.mjs` 扫描 PR diff\n  - 同一文件新增 ≥3 层 fallback 或累计 ≥5 层 → 触发坐标系自检\n  - 自检三问：①修坐标系还是补错误坐标系？②坐标变换能否消除？③每层为什么不能去掉？\n  - 层数合理时在报告中说明理由；不合理时重构后再过 gate\n\nStep 2.7: ARCHITECTURE OWNERSHIP REPORT（F191，warning-only）🔴\n  - 执行：`pnpm check:architecture-ownership`\n  - 从 spec \u002F plan 抄入：\n    `Architecture cell` \u002F `Map delta` \u002F `Why`\n  - 若缺失，报告 `⚠️ missing` 并列为 review focus；不在 quality-gate 做 semantic hard block\n  - 若 `Map delta: none` 但 diff 明显新增 `Store|Queue|Router|Adapter|Dispatcher|Binding` 等架构名词，报告 mismatch 给 reviewer\n  - 若 `Map delta: update required|new cell required`，报告对应 ownership cell \u002F new cell 文件是否随 PR 更新\n  - 注意：quality-gate 只报告机械可见事实；架构语义正确性由 Design Gate + reviewer 判断\n\nStep 3: VERIFY — 逐项检查\n  - 代码在哪？有测试覆盖？边界处理了？\n  - 🔴 F244 Tips Contribution：若本 PR 新增\u002F修改 user-visible feature \u002F capability \u002F guide \u002F harness behavior，\n    必须满足其一：\n    ① `packages\u002Fweb\u002Fsrc\u002Flib\u002Fcapability-tips.seed.json` 有对应 `sourceRef` tip\n    ② 相关 feature\u002Fguide\u002Fskill 文件写明 `tips_exempt: {reason}`\n    并执行 `pnpm check:capability-tips`。\n    注意：CI 只证明结构\u002Fanchor\u002Faction；reviewer 仍要退回只复述标题、没有动作或时机的废话 tip。\n  - 🔴 交付物必须核实 commit\u002FPR 状态（git log --grep + gh pr list）\n    spec checkbox 是记录工具，不是真相源（LL-029）\n  - 🔴 新增 MCP 工具 → 认知入口更新了吗？优先级：MCP tool description → 相关 skill refs → capability wakeup \u002F L0 quick index；只有 legacy\u002Ffallback surface 仍依赖时才补 `MCP_TOOLS_SECTION`（F086 教训：造了工具猫不知道；F203 后不再默认塞 SystemPromptBuilder）\n  - 🔴 新增行为规则 → governance digest \u002F shared-rules 注入更新了吗？\n  - 🔴 产出了 SKILL.md 或改了 MCP tool description → 加载 `writing-skills`，用 T0 六要素审查质量（软硬同检）\n\nStep 4: RUNTIME GUARD — 前端证据采集前先做运行态保护\n  - 若会话在 `cat-cafe-runtime`，先探活：`curl -sf http:\u002F\u002Flocalhost:3004\u002Fhealth`\n  - 服务已在线时直接复用，禁止在该会话执行 `pnpm start` \u002F `pnpm runtime:start` \u002F `.\u002Fscripts\u002Fstart-dev.sh`\n  - `localhost:3003\u002F3004` 默认按 runtime 处理；如果你要验证未合入改动，不能把这两个端口的页面\u002F接口响应当成当前分支的证据\n  - 证明“这是我当前 worktree 的验证证据”时，必须同时说清：`worktree\u002Fcwd` + 目标 URL。两者对不上 = 证据无效\n  - 确需重启时，先获operator明确授权，再用 `CAT_CAFE_RUNTIME_RESTART_OK=1` 执行\n  - **Alpha 优先**：验证已合入 main 的改动时，优先用 `pnpm alpha:start`（3011\u002F3012\u002F4111\u002F6398）取证，而非 runtime。Alpha 环境每次启动自动同步 origin\u002Fmain\n\nStep 4.5: DOGFOOD-YOUR-SLICE — 用一次自己刚做的功能（F209 教训 2026-05-23）🔴\n  对 user-visible \u002F runtime feature，author 必须在请求 review 前：\n    ① 跑一条**真实端到端 query \u002F 路径**，涵盖该 slice 的核心交付能力\n    ② 把命令 + 输出 \u002F 截图证据写进 Quality Gate Report 的 \"Dogfood\" 块\n    ③ 抓到的任何 dogfood bug 必须当轮修，不允许\"post-merge 再说\"\n    ④ **结构性例外**（2026-07-15）：验证路径只在合入后才存在（需 main\u002Falpha 环境或真实外部案例，AC-F7 型）→ pre-merge 验证到能验的边界即可，剩余由**带 owner + 触发条件的持久 post-merge task** 接走，**不阻塞 pre-merge review \u002F merge**；若它是 required AC，则 task 在 terminal PASS（或 `delete` \u002F `cvo_signoff`）前仍阻塞 **feature close**。例外理由写进 review packet\n\n  Scope（必做 vs 可豁免）：\n    - **必做**：任何对最终用户 \u002F 猫体感有变化的 feature 或 bugfix。包括但不限于：\n      search \u002F recall \u002F UI \u002F routing \u002F drillDown \u002F typed reader \u002F 任何新 MCP tool \u002F 任何新 REST 端点 \u002F\n      **任何修复用户或猫可感知路径的 bugfix（即使已有回归测试覆盖）**\n      → 反例 PR #1854 dogfood hotfix：file-slice drillDown 路径口径不一致，已有回归测试也不够——\n        必须 author 自己跑一遍 `search_evidence → drillDown → read_file_slice` 才能抓到\n    - **可豁免**：docs-only \u002F 纯重构 \u002F 纯测试 \u002F 内部基础设施 \u002F **纯内部 bugfix（非 user\u002Fcat 可感知路径，如内部 DB 一致性、log format、纯算法常量调整等）**\n      → 豁免必须**显式在 review packet 里写出理由**（\"docs-only\" \u002F \"纯重构 + 既有测试覆盖\" \u002F \"纯内部 bugfix，不影响 user\u002Fcat 可感知路径\"等），不能省略\n\n  Why（F209 反思 2026-05-23）:\n    \"AC pass 但用户感受不到\" + \"dogfood bug post-merge 才暴露\" 是同型走偏。\n    - Phase B alias registry: AC-B1~B5 全 ✅、跨族 review APPROVE、merge 闭环 — 但生产 `entity_registry` 是空的，真实用户搜 `operator` 找不到 `operator`。\n    - Phase C drillDown: 测试 \u002F cloud review \u002F merge 都过 — 但 author 自己 post-merge 用一次刚发现 file-slice 路径口径不一致。\n    根因是没人 pre-review 真用一次自己刚做的东西。pre-merge dogfood 把这一类 bug 提前到 author 自检阶段。\n\n  报告写法（在 Quality Gate Report 里加 \"### Dogfood\" 块）：\n    ```markdown\n    ### Dogfood-Your-Slice\n    Scope verdict: ✅ 必做 \u002F 🆗 可豁免（理由：xxx）\n\n    （必做时）\n    端到端路径: search_evidence(\"operator\") → drillDown → cat_cafe_get_thread_context\n    实际命令 \u002F 输出（粘贴）: ...\n    发现的 bug: 无 \u002F 列表（含修复 commit SHA）\n    ```\n\nStep 5: PEN CHECK — 自动化设计稿对照（不可跳过！）\n  ① glob designs\u002F**\u002F*.pen，匹配当前 feat 编号或关键词\n  ② 若匹配到 .pen 文件 → 强制进入设计稿对照流程（见下方\"有 .pen 设计稿的功能额外要求\"）\n  ③ 若无匹配 → 检查 feat 是否有前端 UI 改动（改了 packages\u002Fweb\u002Fsrc\u002Fcomponents\u002F）\n     → 有 UI 改动但无 .pen → 在报告中标注\"⚠️ 无设计稿，跳过对照\"\n  ④ 此步骤不依赖猫猫\"记得\"——必须执行 glob 命令，用输出决定是否进入对照\n\nStep 6: RUN — 运行风险匹配的验证命令（必须这次真实运行）\n  ① 先列五轴风险与受影响面；命令逐条对应 claim，不按“写了代码”机械全跑\n  ② 默认：受影响 package \u002F schema \u002F generator \u002F docs checker + git diff --check\n  ③ 新行为 \u002F bug：相关行为或回归测试；现有精确检查红可以直接作 RED\n  ④ 安全、鉴权、生产数据、迁移、外部契约、不可逆，或 targeted 无法覆盖跨包合流风险：pnpm gate\n  ⑤ Redis 相关改动额外跑：pnpm --filter @cat-cafe\u002Fapi test:redis（只连 6398）\n  ⑥ 任一实际选择的检查红都先修；不得挑绿灯报告、隐去红灯\n\nStep 7: READ — 完整读输出，看 exit code，数失败数\n\nStep 7.5: ARTIFACT HYGIENE CHECK — 根目录媒体垃圾闸门\n  - 执行（工作树）：\n    `git status --short | rg '^.. [^\u002F]+\\.(png|jpe?g|webp|gif|webm|mp4|mov|wav|pdf|pen)$'`\n  - 执行（已提交差异）：\n    `git diff --name-only origin\u002Fmain...HEAD | rg '^[^\u002F]+\\.(png|jpe?g|webp|gif|webm|mp4|mov|wav|pdf|pen)$'`\n  - 任一命中 → BLOCK：说明仓库根目录出现了媒体\u002F设计工件（含已跟踪和未跟踪）\n  - 处理方式：移到 `${TMPDIR}\u002Fcat-cafe-evidence\u002F...` 或显式归档到正式目录后再继续\n  - 规则真相源：`cat-cafe-skills\u002Frefs\u002Fevidence-output-contract.md`\n\nStep 8: REPORT — 输出合规报告 + 证据\n```\n\n**前端功能额外要求**：author 必须在正确 worktree \u002F preview 上走关键交互，并记录 URL、操作与结果。截图、录屏、DOM assertion、Playwright 输出都是证据载体；只有视觉判断确实需要画面时才采截图 \u002F 录屏，缺截图本身不阻塞，也不得让 operator 代采。执行细则：`cat-cafe-skills\u002Frefs\u002Fvision-evidence-workflow.md`。\n\n**有 .pen 设计稿的功能额外要求** 🔴（Step 5 匹配到 .pen 时强制执行）：\n1. 打开 .pen 文件 → `get_screenshot` 截取设计稿\n2. Playwright\u002FChrome 打开实际页面 → 截取实现截图\n3. 逐区域对比：布局、颜色、间距、交互状态\n4. 不一致处必须标注并修复（或记录为\"有意偏差 + 原因\"）\n5. 报告附 **设计稿截图 vs 实现截图** 对照表\n6. 🔴 **此流程由 Step 5 自动触发，不依赖猫猫主动想起来**\n\n> 教训（2026-03-11）：三只Ragdoll同时跳过了 .pen 对照，根因是没有自动化检查点。\n> Step 5 的 glob 就是解决这个问题——用命令输出驱动，不靠记忆。\n\n## Quick Reference\n\n| Claim | 需要 | 不够用 |\n|-------|------|--------|\n| 测试通过 | 这次运行输出：0 failures | \"上次跑过\"、\"应该通过\" |\n| targeted checks 通过 | 与改动面对应的本轮命令 + exit 0 | 只挑一盏绿灯、隐去相关红灯 |\n| full gate 通过 | high 风险触发时本轮 `pnpm gate` exit 0 | 低风险为了报告完整机械全跑，或高风险只跑局部 |\n| Bug 修了 | 原症状测试：通过 | 代码改了，以为修了 |\n| 需求满足 | spec + Discussion 逐项打勾 | 测试通过就完事 |\n| Feature 完成\u002F未完成 | git log + PR 状态 + spec 逐项 | 只看 spec checkbox 就下结论 |\n\n**合规报告模板**：\n\n```markdown\n## Quality Gate Report\n\nSpec: feature spec or implementation note\n原始需求: feature-discussions\u002FYYYY-MM-DD-xxx\u002FREADME.md\n检查时间: YYYY-MM-DD HH:MM\n\n### 愿景覆盖（Step 0）\n| # | operator原始需求 | AC 覆盖？ | 实现？ |\n|---|---------------|-----------|--------|\n| 1 | \"我要 XXX\"    | AC#3      | ✅     |\n\n### 功能验收\n| # | 要求 | 状态 | 代码位置 | 测试覆盖 |\n|---|------|------|----------|----------|\n| 1 | XXX  | ✅   | file.ts:L10 | test.spec.ts |\n\n### 设计稿对照（Step 5）\nglob designs\u002F**\u002F*.pen 匹配结果: [列出匹配文件或\"无匹配\"]\n对照状态: ✅ 已对照 \u002F ⚠️ 无设计稿（有 UI 改动）\u002F ➖ 无 UI 改动\n\n### Artifact Hygiene（Step 7.5）\n仓库根目录媒体\u002F设计工件（工作树 + 已提交差异）: 无 ✅\n\n### Architecture Ownership（Step 2.7）\nArchitecture cell: dispatch\nMap delta: none\nWhy: 只扩展现有 InvocationQueue 行为，不改变 dispatch cell 边界\nDiff mismatch scan: 无新增并行 Store\u002FQueue\u002FRouter\u002FAdapter ✅\n\n### Dogfood-Your-Slice（Step 4.5）\nScope verdict: ✅ 必做 \u002F 🆗 可豁免（理由）\n（必做时）端到端路径: search_evidence(\"...\") → drillDown → reader(...)\n实际命令 \u002F 输出 \u002F 截图: ...\n发现的 bug: 无 \u002F 列表（含修复 commit SHA）\n\n### 五轴风险与验证命令（必须是这次真实运行）\n风险: behavior=\u003C...> data=\u003C...> security=\u003C...> contract=\u003C...> irreversible=\u003C...>\n\u003Ctargeted command 1> → exit 0 ✅（覆盖 claim: ...）\n\u003Ctargeted command 2> → exit 0 ✅（覆盖 claim: ...）\npnpm gate → exit 0 ✅（仅 high 风险实际触发时填写）\n```\n\n## Common Mistakes\n\n| 错误 | 正确做法 |\n|------|----------|\n| 只检查 AC，没回读 Discussion | Step 0 先读原始需求，AC 可能不完整 |\n| \"上次跑测试是通过的\" | 这次重新跑，看输出，再声明 |\n| \"应该没问题\" \u002F \"probably works\" | Run the command. Read the output. |\n| 测试通过就声称 phase 完成 | 还要对照 spec 逐项检查 |\n| 部分实现就提 review | P1\u002FP2 遗漏必须当轮补完再提 review |\n| 交付半成品让operator\"先看看\" | 交付完整 feat，步骤是内部节奏不是交付批次 |\n| 产出后续要重写而非扩展 | 如果要重写，说明绕路了（Spike 除外） |\n| author 没跑 frontend preview，把“缺截图”扔给 operator | author 走关键交互；按视觉风险选择截图 \u002F 录屏 \u002F DOM \u002F 浏览器测试证据 |\n| 有 .pen 设计稿但没对照实现 | Step 5 自动 glob 检测，匹配到就强制对照，不靠记忆 |\n| 为了截图在 runtime 会话里重跑 `pnpm start` | 先探活复用现有 runtime；确需重启必须显式授权 |\n| 拿 runtime 的 `3003\u002F3004` 页面当成当前 worktree 的验证结果 | 报告里同时写明 `pwd\u002Fworktree` 和目标 URL；如果 URL 是 `3003\u002F3004`，默认这是 runtime 证据，不是未合入改动证据 |\n| 截图\u002F录屏\u002F设计稿顺手掉进仓库根目录 | Step 7.5 必查；先移到 `${TMPDIR}\u002Fcat-cafe-evidence\u002F...` 或正式归档目录，再继续 |\n| Redis 改动用默认测试命令 | 必须跑 `test:redis`，禁止直连 6399 |\n| 产出了 skill\u002FMCP 但没审查质量 | 加载 `writing-skills`，用 T0 六要素审查（软硬同检） |\n| 只看 spec checkbox 就声称完成\u002F未完成 | 核实 `git log --grep` + `gh pr list` + 实际 commit（LL-029）|\n| AC 全 ✅ 就声明 phase close（机制 ship 但用户感受不到）| Step 4.5 Dogfood-Your-Slice：必做 feature 跑一条真实端到端 query 写进报告；豁免必须显式写理由（F209 反思 2026-05-23）|\n\n**Red flags — 立刻 STOP**：\n- 用 \"should\"、\"probably\"、\"seems to\"\n- 表达满足感（\"好了！\"、\"完成！\"）时还没运行命令\n- 信任 subagent 的 \"success\" 报告而没独立验证\n\n## 和其他 skill 的区别\n\n| Skill | 关注点 | 时机 |\n|-------|--------|------|\n| **quality-gate（本 skill）** | spec 对照 + 风险匹配证据 | 作完成声明之前 |\n| `merge-gate` | reviewer 是否放行、P1\u002FP2 是否全修 | 合入 main 之前 |\n| `receive-review` | 如何处理 reviewer 的反馈 | 收到 review 之后 |\n\n一句话：quality-gate 是\"你自己检查自己\"，merge-gate 是\"reviewer 放行你\"，receive-review 是\"你处理 reviewer 的意见\"。\n\n## 下一步\n\nQuality Gate 通过后，把证据交给风险路由已选择的独立验证源：治理 \u002F stateful 语义通常走 `request-review`；安全 \u002F 契约的 context-blind 扫描可走 cloud；`fresh-context-review` 仅在 author 判断认知盲点收益足够时作为 finding generator，不是固定前置。\n\nGate 未通过时：\n- **P1 遗漏** → 补完再过 gate\n- **P2 遗漏** → 必须当轮补完再提 review\n- **已选择的 targeted \u002F full 检查失败** → 修到绿灯再交付\n",{"name":5,"triggers":24,"description":29},[25,26,27,28],"开发完了","准备 review","自检","声称完成","开发完成后的自检门禁：愿景对照 + spec 合规 + 验证。 Use when: 准备对交付作完成声明、需要整理风险匹配的自证。 Not for: 收到 review 反馈（用 receive-review）、merge（用 merge-gate）。 Output: Spec 合规报告（含愿景覆盖度）。\n","main","e43f83d5ceb309323cae7e0f31e5e48fd816a57d",".claude\u002Fskills\u002Fquality-gate","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI","https:\u002F\u002Fgithub.com\u002Fpeps1666","https:\u002F\u002Fwww.cug.edu.cn\u002F","My name is Zhou Junhao, and I am from China University of Geosciences (Wuhan). My major is Resources and Environment, and my research direction is Remote Sensin","2026-08-16 00:25:38",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":50},[40,43,46],{"tool":41,"command":42},"npx","npx skills add peps1666\u002FBuildCrew-AI --skill quality-gate",{"tool":44,"command":45},"bunx","bunx skills add peps1666\u002FBuildCrew-AI --skill quality-gate",{"tool":47,"command":48},"pnpm","pnpm dlx skills add peps1666\u002FBuildCrew-AI --skill quality-gate","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fquality-gate\u002FSKILL.md",true,[],[53,59,66,73,80,87],{"skillNo":54,"name":55,"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":56,"categories":57,"keywords":58,"publishedAt":19},"01M7APYYSHV2SSSRV5Q15JWWPF","plugin-reconcile-skill","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002Fplugins\u002Ftest-reconcile-plugin-regr\u002Fskills\u002Fplugin-reconcile-skill\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M7APYWAJ119TPF079F2AXWAS","weixin-mp","通过 Limb 体系操作微信公众号：发布文章、上传图片、管理草稿。 Use when: 需要发布内容到微信公众号、查看草稿、检查公众号连接状态。 Not for: 其他平台的发布、纯文本聊天、非公众号相关操作。 Output: 微信公众号操作结果（发布ID、草稿列表、图片URL等）。","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002Fpackages\u002Fapi\u002Fsrc\u002Fplugins\u002Fweixin-mp\u002Fskills\u002Fweixin-mp\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7APYNNEMBP2T62WT0JT7GNE","writing-skills","创建或修改 Clowder AI skill \u002F MCP tool description 的元技能（含质量标准、范本、发布）。 Use when: 写新 skill、修改现有 skill、写\u002F改 MCP tool description、验证 skill 质量； 或者功能实现中产出了 SKILL.md \u002F cat-cafe-skills\u002F 新目录 \u002F manifest.yaml skill 条目。 Not for: 使用 skill（直接触发对应 skill）。 Output: 新\u002F更新的 SKILL.md + manifest 条目 + symlinks。 GOTCHA: 软硬同重——skill\u002FMCP 质量 = 代码质量；不要写模型已知的通用教程，先过价值门禁。","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002Fcat-cafe-skills\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7APYHJDXRH9EDP5D3JZHSVN","writing-plans","将 spec\u002F需求拆分为可执行的分步实施计划。 Use when: 有 spec 或需求，准备动手前需要拆分步骤。 Not for: trivial 改动（≤5 行）、已有详细计划。 Output: 分步实施计划（含 TDD 步骤和检查点）。","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002Fcat-cafe-skills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7APYD2SSZ6Y6CF5SD3YZ5C0","worktree","为代码、脚本、API 与第一方执行面创建隔离 Git worktree，并配置 Redis 6398；classifier 放行的 co-creation docs direct push 不进入本流程。","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002Fcat-cafe-skills\u002Fworktree\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7APY8R4E7RR2WZVPH9V8WWP","workspace-navigator","猫猫把“打开文档、代码或日志”等模糊意图解析成本地绝对路径或 worktree 相对路径，并返回 applied、queued、blocked 或 unconfirmed 的真实 Workspace 投递状态。","https:\u002F\u002Fgithub.com\u002Fpeps1666\u002FBuildCrew-AI\u002Fblob\u002Fmain\u002Fcat-cafe-skills\u002Fworkspace-navigator\u002FSKILL.md",[],[]]