zbh-s-skills

Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend.

Tests in real browsers. Use when building or debugging anything that runs in a browser. Use when you need to inspect the DOM, capture console errors, analyze network requests, profile performance, or verify visual output with real runtime data via Chrome DevTools MCP.

Automates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to automate quality gates, configure test runners in CI, or establish deployment strategies.

Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity.

Optimizes agent context setup. Use when starting a new session, when agent output quality degrades, when switching between tasks, or when you need to configure rules files and context for a project.

Guides systematic root-cause debugging. Use when tests fail, builds break, behavior doesn't match expectations, or you encounter any unexpected error. Use when you need a systematic approach to finding and fixing the root cause rather than guessing.

Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.

Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.

Builds production-quality UIs. Use when building or modifying user-facing interfaces. Use when creating components, implementing layouts, managing state, or when the output needs to look and feel production-quality rather than AI-generated.

Refines ideas iteratively. Refine ideas through structured divergent and convergent thinking. Use "idea-refine" or "ideate" to trigger.

Delivers changes incrementally. Use when implementing any feature or change that touches more than one file. Use when you're about to write a large amount of code at once, or when a task feels too big to land in one step.

Optimizes application performance. Use when performance requirements exist, when you suspect performance regressions, or when Core Web Vitals or load times need improvement. Use when profiling reveals bottlenecks that need fixing.

Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.

Hardens code against vulnerabilities. Use when handling user input, authentication, data storage, or external integrations. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services.

Prepares production launches. Use when preparing to deploy to production. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.

Grounds every implementation decision in official documentation. Use when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.

Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague idea.

Drives development with tests. Use when implementing any logic, fixing any bug, or changing any behavior. Use when you need to prove that code works, when a bug report arrives, or when you're about to modify existing functionality.

Discovers and invokes agent skills. Use when starting a session or when you need to discover which skill applies to the current task. This is the meta-skill that governs how all other skills are discovered and invoked.

考试答题辅助技能：适用于期末考试、课程作业、章节练习等答题场景。采用3轮验证机制确保答案可靠性。Use when: 答题、做题、考试、作业、选择题、简答题、计算题、分析题。不适用于论文撰写或科研问题。

用于"课程实验带练、实验排错、截图规划、实验报告生成、Word文档生成、实验复盘"类任务。Use when: 手把手带我做实验、从零开始做实验、帮我排查实验报错、按模板生成实验报告、生成Word实验报告、实验复盘学习、截图规划、结合代码环境报错一步步教我。不适用于纯理论问答、无材料编造成果、与实验无关的润色。

中文工程 Skill 调用流总控技能：用于复杂工程实现、多方案工程设计、架构改造、跨文件功能开发、技术 spike、候选实现筛选、工程 Gate、增量切片、验证审计和交付记忆。Use when: 工程调用流、工程skill路由、多方案实现、实现候选池、技术spike、工程Gate、复杂工程任务、架构改造、多文件开发、候选方案筛选、Define Plan Build Verify Review Ship 优化。不适用于：单文件小修、普通代码解释、直接执行已明确的简单任务；路由后应切换到对应阶段主 skill。

项目理解与工程开发技能：覆盖代码阅读理解、逐行代码讲解、语法拆解、项目架构解析、后端链路分析、工程化开发规范。Use when: 理解代码、解释这行代码、逐段讲解一个方法、语法教学、解析项目、分析后端链路、接口追踪、数据流分析、工程开发、代码Review、架构梳理。不适用于软著项目（使用 software-copyright-zh）。

生成和更新中文项目接班与上下文入口文档，用于项目切换 AI、长期科研/工程项目丢失上下文、需要沉淀项目统一认知、AI接班手册、工作流细化、单文件记忆桥、三层记忆入口、总览索引、当前状态补丁、下一步优先级和文档更新规则时使用。Use when: 接班手册、新AI继承、项目统一认知、工作流细化、上下文恢复、交接文档、科研项目交接、AI换人继续项目、单文件记忆、记忆文档分层、AGENTS/CLAUDE规则整理。

项目启动交付技能：用于外包、比赛、课程和工程项目从读题、调研、需求拆解、技术选型、团队分工、接口/数据库设计、启动命令到启动记忆入口的交付流程。Use when: 项目启动、外包项目、比赛项目、团队分工、技术选型、需求拆解、接口文档、数据库设计、项目计划、启动命令、启动记忆、AGENTS读取顺序、前后端联调、交付验收。

项目文件树架构与持续治理技能：识别 Web、前端、后端、Monorepo、微服务、科研、数据科学、机器学习、Python 库或 CLI 项目，选择并生成标准蓝图，记录目录职责，在新增页面、接口、模型、服务、包、研究步骤、实验、流水线、脚本、数据、产物或文档前给出唯一合理路径，并审计结构漂移。Use when: 新建项目、项目初始化、设计或生成文件树、架构搭建、技术栈或部署边界划分、前后端分离、apps/packages、科研步骤或 pipeline 组织、创建目的地不明确的文件或目录、增加主要模块、重构或迁移目录、现有仓库结构治理、检查同义目录或根目录堆积或源码与产物混放、任何工作流将创建或改变项目结构时。

中文 Web Design 与 Vibe Coding 总控工作流：按新建网站、现有页面改版、图像先行和正式产品交付选择最少必要 skill，执行需求规格化、DESIGN.md、审美批判、纵向切片、工程实现、真实浏览器验收和上线门禁。Use when: 做网站、设计页面、landing page、portfolio、产品页、网站高级感、页面太丑、改版前端、生成 DESIGN.md、image-to-code、Vibe Coding、Web UI 验收、避免 AI 味、前端审美工作流。

Research and synthesize context-appropriate references before creating or redesigning websites, landing pages, Web/UI flows, dashboards, presentations, coding-agent prompts and skills, data visualizations, scientific or architecture diagrams, templates, or color/type/icon/illustration systems. Do not trigger for routine bug fixes, pure algorithms, factual questions, translation, one-line code edits, non-design coding, explicit no-network requests, or strict local edits against a complete supplied reference where no exploration is wanted. Use when: website design, landing page, Web UI flow, dashboard, presentation, PPT, coding prompt, agent prompt, skill design, data visualization, scientific diagram, architecture diagram, template selection, color system, typography, icon system, illustration style, visual improvement, reference-driven creation.

中文迭代反思守门技能：用于科研、算法、工程、方案设计等任何“继续迭代/提出计划/改进方法/复盘经验/避免重复历史错误/保证创新性/列出致命痛点/自我迭代”的场景。Use when: 流程迭代开始前需要吸取历史经验并提出计划，提出新方法后需要列出5个致命痛点，并在痛点分析后连续自我修订3-5轮再定稿；迭代完成后需要主动总结经验、失败边界和下次不要重复的错路。

中文工程执行防自我衍生技能：用于严格按照参考计划文档、题面、方案书、AGENTS.md、任务书、实验计划或用户指定边界执行工程、建模、代码、实验和报告任务；禁止 AI 自作主张扩展参数范围、目标函数、约束条件、文件结构、实验口径、输出格式或结论表述；遇到计划缺失、冲突、不确定或需要新增假设时，必须先提出具体问题并等待用户解答；任务结束时主动检查是否存在自我衍生、越权实现、未授权假设和计划偏离。Use when: 严格按计划执行, 参考计划文档, 不允许自我发挥, 防止自作主张, 参数范围锁定, E范围, 工程问题, 建模代码, 复现方案, 按文档实现, 有疑问先问, 结束自检。

中文 skills 总控路由技能：用于在 C:\Users\zbh\.agents\skills 中按任务领域、阶段、风险和交付物选择最少必要 skill 组合，避免一次性加载全量技能。Use when: 技能路由、选择skill、统筹skills库、该用哪个技能、组合多个skill、开始任务前分流、Codex自如使用skills、优化skills调用。不适用于：直接执行具体专业任务，路由后应切换到对应领域 skill。

中文子代理编排技能：用于把 Codex subagents、/sub、多代理协调、并行委派、explorer/worker、TOML agent、awesome-codex-subagents 角色库和本地 skills 路由结合起来；约束何时允许真实 spawn 子代理、何时只给委派方案、如何划分父代理/子代理职责、如何避免写范围冲突、如何把科研与工程任务的子代理结果回收到本地审计和验收流程。Use when: subagent, subagents, /sub, 子代理, 多代理, 多代理协调, 并行代理, 并行委派, 委派执行, worker, explorer, spawn_agent, TOML agent, awesome-codex-subagents, Codex-Subagent-Orchestrator, 子代理审计, 子代理调度。不适用于：用户没有明确要求子代理或并行委派的普通深入分析、普通代码修改、普通科研实验；这些任务应继续走本地领域 skill。

工作流提炼与生成技能：从零散经验/多轮对话/已有流程中提炼出结构化、可复用的工作流，或为新任务设计工作流。Use when: 总结工作流、提炼流程、生成SOP、设计工作流、流程优化、把经验变成流程、梳理步骤、生成skill工作流。不适用于执行具体工作流（执行请使用对应领域skill）。

信息证据链技能：用于资料收集、分类检索、真实性验证、来源链接整理、证据链表格、调研报告和带来源的结论输出。Use when: 收集信息、查资料、调研、证据链、来源链接、真实性验证、资料分类、文献链接、网站来源、竞品资料、政策资料、行业数据。

全面知识总结技能：全局可用，在任务完成后提炼垂直领域知识点、工作流方法论、AI协作技巧，用小白举例帮助真正学到东西。Use when: 总结知识点、学习总结、知识卡片、帮我学到东西、这次学到了什么、知识提炼。每次任务结束后自动触发（由全局指令驱动），也可在任意工作区手动调用。

项目 docs 知识点沉淀技能：在完成有复用价值的项目问答、代码解释、工作流讲解、设计决策或排错复盘后，把本轮最关键的 1 个知识点写入当前项目 docs/knowledge/ 的单篇 Markdown 文档。Use when: 每次问答结尾、项目知识沉淀、docs 知识库、一个知识点一篇文档、问答复盘、技术概念小白解释、工作流经验记录、代码链路解释记录。不适用于：闲聊、简单确认、纯文件操作、没有可复用知识点的任务。

Agent 后台监控协议技能：用于长时间任务的后台启动、wait 轮询、进度文件监控、日志监控、卡死判定、自动续跑、失败重试、最终收口和无人值守实验托管。Use when: 后台监控、agent wait、长任务、无人值守、watchdog、自动续跑、卡死恢复、进度轮询、MATLAB长任务、Python长任务、PowerShell后台任务、manifest、checkpoint、结果文件监控。

产物归档整理与过时识别技能：扫描 skill-outputs（按 skill 子目录与 legacy-flat）、实验结果、日志等；可选脚本将根目录 legacy 一键迁入 skill 子目录。Use when: skill-outputs 整理、自动按技能分文件夹、legacy 迁移、过时候选、artifact index。

PPT 数据叙事与图表规格技能：根据比较、趋势、分布、关系、组成和不确定性选择图表，建立原始数据到指标、结论、视觉编码和来源的映射，检查坐标轴、统计口径、方向与误导风险，输出结论先行的 chart-spec.json。Use when: 科研答辩、数学建模PPT、商业数据汇报、图表选型、数据故事、图表误导检查、chart-spec.json。

PPT 视觉参考库技能：按封面、数据页、流程页按需加载成对的优秀/反例 PNG，解释层级、留白、图表、对齐、节奏和 AI 模板化问题，并把选用规则写入视觉系统。Use when: PPT视觉参考、好坏示例、审美门禁、封面设计、数据页设计、流程页设计。