القائمة
为 CodeNote Helper 的技术原理、八股讲解、项目追问、从零补课和项目实现复述生成中文解释；涉及最新官方文档、浏览器 API、OAuth、benchmark、现代库或争议结论时先调用 $web-search。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
当用户要求技术原理讲解、八股讲解、从零教学、面试口述、项目追问回答、领域补课、把项目实现转成可复习表达，或在缺少领域背景时需要先理解概念再推进项目时使用；覆盖后端、前端、数据库、分布式、系统设计、编译构建、DevOps、安全、产品业务、数据分析、Agent、LLM、科研方法等可迁移领域。若涉及最新论文、官方文档、benchmark、争议结论或现代 API，先调用 $web-search。
在项目 AGENTS.md 约束下生成可直接交给 Codex 或 Agent 执行的中文任务 prompt。用于开发、修复、文档、验证、审计、治理或交接任务的 prompt 化，但不承载 Plan mode 和 code review 的完整模式规则。
基于用户需求和项目真实上下文创建或更新项目本地 skill。用于把高频协作流程、领域任务、项目规范、prompt 生成流程或审查流程沉淀为可复用 skill，并避免把一次性任务误做成长期 skill。
基于项目真实背景、用户长期偏好和现有文档生成或更新项目级 AGENTS.md。用于新项目初始化、迁移协作规则、整理语言编码测试版本文档约束、沉淀长期协作底线和交付格式时使用。
为 CodeNote Helper 生成 code review 中文 prompt。用于审查当前 diff、指定 commit、PR、发布前风险、文档一致性或扩展审核风险；默认只生成审查任务 prompt，不直接 review、不直接修改代码，除非用户明确要求审查并修复。
为 CodeNote Helper 生成普通开发、修复、验证、治理、文档和审核友好类中文执行 prompt。用于把一次具体任务整理成可直接交给 Codex 或 Agent 执行的 prompt；不承载 Plan mode prompt、code review prompt 或项目 skill creator 的完整职责。
| name | knowledge-explainer |
| description | 为 CodeNote Helper 的技术原理、八股讲解、项目追问、从零补课和项目实现复述生成中文解释；涉及最新官方文档、浏览器 API、OAuth、benchmark、现代库或争议结论时先调用 $web-search。 |
本 skill 用于把 CodeNote Helper 相关技术、项目实现、修复取舍和面试追问讲清楚。它服务于技术原理讲解、八股复习、从零补课、项目答辩、项目追问和把真实实现转成可复述表达。
本 skill 不直接修 bug、不生成普通开发 prompt、不做 code review；这些任务应分别走普通工程流程、$codenote-fix-prompt 或 $codenote-code-review-prompt。
字数约束是最高优先级约束。默认完整讲解必须包含：
可直接口述回答（快速复习总结，>=1000字）：不少于 1000 字。详细原理讲解（通俗版，>=3000字，含公式）：不少于 3000 字。未达字数门槛视为输出失败，必须继续补写，直到达到要求。不得把 1000 / 3000 字硬门槛改成“尽量详细”“适当展开”或“按需补充”。如果用户明确要求极短回答，可以先给短答，但不能声称已经完成本 skill 的完整讲解流程。
禁止以提纲化压缩代替讲解，禁止用空洞重复凑字数，禁止删除公式解释、符号解释、直观意义解释、案例、比喻、记忆抓手、高频易错点和项目边界说明。讲解必须从最基础概念开始，按层递进，耐心细致展开。
涉及以下内容时，必须先调用 $web-search：
chrome.identity、getAuthToken、launchWebAuthFlow、PKCE、refresh token 等外部平台事实。不依赖外部事实时，优先基于 AGENTS.md、DEVLOG.md、README.md、相关代码、测试和 fix report 解释。
结合当前项目讲解时，按需要读取：
AGENTS.mdAGENTS.override.md 存在时读取它。DEVLOG.mdREADME.md不要无目标扫描整个仓库；不要修改根目录 references/ 的非项目代码。
默认完整讲解必须包含以下结构。只有用户明确要求一句话定义、极短摘要或单点说明时，才能裁剪；裁剪时必须说明这是短答，不是完整讲解。
适合面试、答辩或团队沟通时直接说出来。先给结论，再讲为什么、解决了什么问题、和项目有什么关系、边界在哪里。必须自然可口述，不能写成零散 bullet。
从最基础概念开始讲起，再逐层解释机制、流程、公式、状态变化、因果链条和工程取舍。涉及公式时，必须包含公式解释、符号解释和直观意义解释；涉及抽象机制时，必须给出案例、比喻、记忆抓手和高频易错点。
对应到 CodeNote Helper 的真实模块、流程、数据、接口、文档、测试或历史报告。必须区分已实现、正在设计、后续可扩展和需要验证，不能把项目未实现能力说成已经完成。
列出面试、答辩、方案评审或团队沟通中可能出现的追问，并给出可直接口述的回答。回答要能回到真实证据和项目边界。
列出本轮讲解依赖的项目文件、测试、fix report 或 $web-search 外部依据，并说明哪些是已确认事实、哪些是工程推断、哪些仍需真实环境验证。
$web-search 的来源结论。$skill-name 形式。输出前检查：
$web-search。可直接口述回答（快速复习总结，>=1000字）、详细原理讲解（通俗版，>=3000字，含公式）、项目落地点和面试官 / 评审者可能追问与回答。