https://ai.wujiong.cc/tags/%E4%BB%A3%E7%A0%81%E8%AE%B2%E8%A7%A3/Recent content in 代码讲解 on AI 观察Hugozh-CNSun, 18 Oct 2026 08:43:41 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-claude-app-skill/Sun, 18 Oct 2026 08:43:41 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-claude-app-skill/<p>「代码讲解」是开发者的高频任务。它的输入通常是模块路径，期望得到的是分层讲解文档。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。</p> <p>本文介绍如何在 <strong>Claude 应用中的 Skills</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-agents-sdk/Sun, 18 Oct 2026 08:17:58 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-agents-sdk/<p>如果你在代码仓库与终端里反复做代码讲解，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。</p> <p>本文介绍如何在 <strong>OpenAI Agents SDK</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-copilot-instructions/Sun, 18 Oct 2026 08:02:42 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-copilot-instructions/<p>把「代码讲解」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（模块路径），按什么顺序处理，交付什么（分层讲解文档），哪些事不能做。Skill 就是把这些写下来的载体。</p> <p>本文介绍如何在 <strong>GitHub Copilot 指令与提示文件</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-gpts/Sun, 18 Oct 2026 07:50:17 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-gpts/<p>如果你在代码仓库与终端里反复做代码讲解，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。</p> <p>本文介绍如何在 <strong>GPTs</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p> <h2 id="这个技能做什么">这个技能做什么</h2> <table> <thead> <tr> <th>项目</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>技能</td> <td>代码讲解（<code>code-explainer</code>）</td> </tr> <tr> <td>作用</td> <td>为新人逐层讲解一个模块：职责、数据流、关键函数</td> </tr> <tr> <td>输入</td> <td>模块路径</td> </tr> <tr> <td>输出</td> <td>分层讲解文档</td> </tr> <tr> <td>形态</td> <td>纯提示词</td> </tr> <tr> <td>风险</td> <td>低</td> </tr> <tr> <td>适用人群</td> <td>开发者</td> </tr> </tbody> </table> <p>处理流程分四步：</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-dify-workflow/Sun, 18 Oct 2026 07:40:26 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-dify-workflow/<p>如果你在代码仓库与终端里反复做代码讲解，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。</p> <p>本文介绍如何在 <strong>Dify 工作流</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-faq/Sun, 18 Oct 2026 07:34:59 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-faq/<p>开发者经常要做「代码讲解」这类事：为新人逐层讲解一个模块：职责、数据流、关键函数。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。</p> <table> <thead> <tr> <th>项目</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>技能</td> <td>代码讲解（<code>code-explainer</code>）</td> </tr> <tr> <td>作用</td> <td>为新人逐层讲解一个模块：职责、数据流、关键函数</td> </tr> <tr> <td>输入</td> <td>模块路径</td> </tr> <tr> <td>输出</td> <td>分层讲解文档</td> </tr> <tr> <td>形态</td> <td>纯提示词</td> </tr> <tr> <td>风险</td> <td>低</td> </tr> <tr> <td>适用人群</td> <td>开发者</td> </tr> </tbody> </table> <h2 id="1-代码讲解技能和直接写提示词有什么区别">1. 「代码讲解」技能和直接写提示词有什么区别？</h2> <p>技能把步骤、格式和约束固定下来，由平台在相关时自动加载；提示词需要每次手动提供，效果依赖当次写法。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-eval/Sun, 18 Oct 2026 06:59:32 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-eval/<p>「代码讲解」是开发者的高频任务。它的输入通常是模块路径，期望得到的是分层讲解文档。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。</p> <p>“感觉好用”不足以说明技能有效。下面给出一套轻量的评估方法，用来判断「代码讲解」是否达标，以及每次修改后是变好还是变坏。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-function-calling/Sun, 18 Oct 2026 06:57:58 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-function-calling/<p>如果你在代码仓库与终端里反复做代码讲解，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。</p> <p>本文介绍如何在 <strong>Function Calling</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-cursor-rules/Sun, 18 Oct 2026 06:37:08 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-cursor-rules/<p>把「代码讲解」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（模块路径），按什么顺序处理，交付什么（分层讲解文档），哪些事不能做。Skill 就是把这些写下来的载体。</p> <p>本文介绍如何在 <strong>Cursor Rules</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-checklist/Sun, 18 Oct 2026 06:27:22 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-checklist/<p>把「代码讲解」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（模块路径），按什么顺序处理，交付什么（分层讲解文档），哪些事不能做。Skill 就是把这些写下来的载体。</p> <p>把下面的清单保存下来，每次使用或修改「代码讲解」技能时过一遍。</p> <h2 id="编写时">编写时</h2> <ul> <li><input disabled="" type="checkbox"> description 写清做什么、什么时候用</li> <li><input disabled="" type="checkbox"> 输入写明需要模块路径，并要求缺信息先提问</li> <li><input disabled="" type="checkbox"> 步骤为编号列表：先给模块一句话职责、画出数据流、逐个讲关键函数、列出常见修改入口</li> <li><input disabled="" type="checkbox"> 输出写明分层讲解文档的结构</li> <li><input disabled="" type="checkbox"> 约束包含领域底线与不可逆操作的处理方式</li> <li><input disabled="" type="checkbox"> 长资料拆到参考文件</li> </ul> <h2 id="上线前">上线前</h2> <ul> <li><input disabled="" type="checkbox"> 6 类测试输入全部通过</li> <li><input disabled="" type="checkbox"> 权限按最小范围配置</li> <li><input disabled="" type="checkbox"> 技能文件中没有密钥和真实个人信息</li> <li><input disabled="" type="checkbox"> 有负责人和变更记录</li> </ul> <h2 id="每次使用时">每次使用时</h2> <ul> <li><input disabled="" type="checkbox"> 输入材料已脱敏或确认可以交给所用平台</li> <li><input disabled="" type="checkbox"> 观察智能体是否加载了技能</li> <li><input disabled="" type="checkbox"> 查看“需人工确认”清单</li> <li><input disabled="" type="checkbox"> 对照原始材料抽查关键信息</li> <li><input disabled="" type="checkbox"> 风险较低，但输出仍需快速过目再使用</li> </ul> <h2 id="使用后">使用后</h2> <ul> <li><input disabled="" type="checkbox"> 记录明显的问题样例</li> <li><input disabled="" type="checkbox"> 输出被大幅修改时，分析原因并考虑改技能</li> <li><input disabled="" type="checkbox"> 定期检查平台更新是否影响技能</li> </ul> <h2 id="每一步的快速核对">每一步的快速核对</h2> <ul> <li><input disabled="" type="checkbox"> 先给模块一句话职责</li> <li><input disabled="" type="checkbox"> 画出数据流</li> <li><input disabled="" type="checkbox"> 逐个讲关键函数</li> <li><input disabled="" type="checkbox"> 列出常见修改入口</li> </ul> <p>清单只是底线，深入内容见<a href="https://ai.wujiong.cc/posts/2026-10-18-code-explainer-pitfalls/">常见坑</a>与<a href="https://ai.wujiong.cc/posts/2026-10-18-code-explainer-security-review/">安全审查</a>。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-minimal-vs-advanced/Sun, 18 Oct 2026 06:16:38 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-minimal-vs-advanced/<p>开发者经常要做「代码讲解」这类事：为新人逐层讲解一个模块：职责、数据流、关键函数。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。</p> <p>很多人纠结一开始要不要把技能写得很完整。答案是：先极简，再按需升级。下面对比「代码讲解」的两种写法。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-intro/Sun, 18 Oct 2026 05:43:40 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-intro/<p>开发者经常要做「代码讲解」这类事：为新人逐层讲解一个模块：职责、数据流、关键函数。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。</p> <h2 id="一句话说明">一句话说明</h2> <p>「代码讲解」技能让智能体为新人逐层讲解一个模块：职责、数据流、关键函数。你提供模块路径，它按固定步骤处理，交付分层讲解文档。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-combo/Sun, 18 Oct 2026 05:43:32 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-combo/<p>「代码讲解」是开发者的高频任务。它的输入通常是模块路径，期望得到的是分层讲解文档。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。</p> <p>单个技能解决一个环节，把几个技能串起来，才能覆盖一整段工作。本文示范「代码讲解」与三个相关技能的组合。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-mcp-server/Sun, 18 Oct 2026 05:10:23 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-mcp-server/<p>「代码讲解」是开发者的高频任务。它的输入通常是模块路径，期望得到的是分层讲解文档。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。</p> <p>本文介绍如何在 <strong>MCP 服务</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p> <h2 id="这个技能做什么">这个技能做什么</h2> <table> <thead> <tr> <th>项目</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>技能</td> <td>代码讲解（<code>code-explainer</code>）</td> </tr> <tr> <td>作用</td> <td>为新人逐层讲解一个模块：职责、数据流、关键函数</td> </tr> <tr> <td>输入</td> <td>模块路径</td> </tr> <tr> <td>输出</td> <td>分层讲解文档</td> </tr> <tr> <td>形态</td> <td>纯提示词</td> </tr> <tr> <td>风险</td> <td>低</td> </tr> <tr> <td>适用人群</td> <td>开发者</td> </tr> </tbody> </table> <p>处理流程分四步：</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-langgraph-tool/Sun, 18 Oct 2026 05:05:43 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-langgraph-tool/<p>「代码讲解」是开发者的高频任务。它的输入通常是模块路径，期望得到的是分层讲解文档。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。</p> <p>本文介绍如何在 <strong>LangChain / LangGraph 工具</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-skill-md/Sun, 18 Oct 2026 05:03:30 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-skill-md/<p>开发者经常要做「代码讲解」这类事：为新人逐层讲解一个模块：职责、数据流、关键函数。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。</p> <p>本文以「代码讲解」为例，逐段讲解 SKILL.md 的写法。SKILL.md 是 Claude Agent Skills 采用的格式：YAML 头 + Markdown 正文，其结构思路也适用于其他平台的规则文件与指令。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-agents-md/Sun, 18 Oct 2026 04:38:56 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-agents-md/<p>开发者经常要做「代码讲解」这类事：为新人逐层讲解一个模块：职责、数据流、关键函数。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。</p> <p>本文介绍如何在 <strong>AGENTS.md</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-troubleshooting/Sun, 18 Oct 2026 04:35:13 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-troubleshooting/<p>开发者经常要做「代码讲解」这类事：为新人逐层讲解一个模块：职责、数据流、关键函数。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。</p> <p>「代码讲解」技能出问题时，先别急着重写。按下面的表格对号入座，大部分问题都能在几分钟内定位。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-security-review/Sun, 18 Oct 2026 04:11:54 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-security-review/<p>把「代码讲解」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（模块路径），按什么顺序处理，交付什么（分层讲解文档），哪些事不能做。Skill 就是把这些写下来的载体。</p> <h2 id="风险画像">风险画像</h2> <p>这个技能是纯指令型，主要风险来自输入内容本身（提示注入、敏感信息）与输出被直接使用。风险较低，但输出仍需快速过目再使用。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-n8n-agent/Sun, 18 Oct 2026 03:57:34 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-n8n-agent/<p>开发者经常要做「代码讲解」这类事：为新人逐层讲解一个模块：职责、数据流、关键函数。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。</p> <p>本文介绍如何在 <strong>n8n AI Agent</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-scenario-walkthrough/Sun, 18 Oct 2026 03:28:59 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-scenario-walkthrough/<p>开发者经常要做「代码讲解」这类事：为新人逐层讲解一个模块：职责、数据流、关键函数。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。</p> <h2 id="背景虚构">背景（虚构）</h2> <p>老陈是一名开发者，每周都要做几次代码讲解。过去靠复制粘贴提示词，结果不稳定。这次团队把它做成了技能，下面记录一次完整运行。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-test-cases/Sun, 18 Oct 2026 02:54:38 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-test-cases/<p>把「代码讲解」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（模块路径），按什么顺序处理，交付什么（分层讲解文档），哪些事不能做。Skill 就是把这些写下来的载体。</p> <p>技能写好后，最常见的问题是“演示时很好，真用时出错”。原因通常是只用一份理想样例试过。本文给「代码讲解」准备 6 类测试输入。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-team-rollout/Sun, 18 Oct 2026 02:48:27 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-team-rollout/<p>「代码讲解」是开发者的高频任务。它的输入通常是模块路径，期望得到的是分层讲解文档。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。</p> <p>一个人用得顺手的技能，推广到团队时会遇到新问题：放在哪、谁来改、怎么知道它变好了还是变坏了。下面以「代码讲解」为例给出落地做法。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-coze-workflow/Sun, 18 Oct 2026 02:35:51 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-coze-workflow/<p>开发者经常要做「代码讲解」这类事：为新人逐层讲解一个模块：职责、数据流、关键函数。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。</p> <p>本文介绍如何在 <strong>扣子（Coze）智能体与工作流</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-claude-code-skill/Sun, 18 Oct 2026 02:34:55 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-claude-code-skill/<p>「代码讲解」是开发者的高频任务。它的输入通常是模块路径，期望得到的是分层讲解文档。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。</p> <p>本文介绍如何在 <strong>Claude Code Skill</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p> <h2 id="这个技能做什么">这个技能做什么</h2> <table> <thead> <tr> <th>项目</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>技能</td> <td>代码讲解（<code>code-explainer</code>）</td> </tr> <tr> <td>作用</td> <td>为新人逐层讲解一个模块：职责、数据流、关键函数</td> </tr> <tr> <td>输入</td> <td>模块路径</td> </tr> <tr> <td>输出</td> <td>分层讲解文档</td> </tr> <tr> <td>形态</td> <td>纯提示词</td> </tr> <tr> <td>风险</td> <td>低</td> </tr> <tr> <td>适用人群</td> <td>开发者</td> </tr> </tbody> </table> <p>处理流程分四步：</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-pitfalls/Sun, 18 Oct 2026 02:11:23 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-pitfalls/<p>如果你在代码仓库与终端里反复做代码讲解，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。</p> <p>下面是把「代码讲解」做成技能时最常见的 8 个问题，每条都给出改法。</p> <h2 id="1-描述写成口号">1. 描述写成口号</h2> <p>智能体判断不出何时该用。改为“为新人逐层讲解一个模块：职责、数据流、关键函数；当用户提到代码讲解时使用”。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-windsurf-rules/Sun, 18 Oct 2026 02:08:29 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-windsurf-rules/<p>开发者经常要做「代码讲解」这类事：为新人逐层讲解一个模块：职责、数据流、关键函数。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。</p> <p>本文介绍如何在 <strong>Windsurf Rules</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-cline-rules/Sun, 18 Oct 2026 01:59:43 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-cline-rules/<p>开发者经常要做「代码讲解」这类事：为新人逐层讲解一个模块：职责、数据流、关键函数。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。</p> <p>本文介绍如何在 <strong>Cline Rules</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-quickstart/Sun, 18 Oct 2026 00:45:38 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-quickstart/<p>「代码讲解」是开发者的高频任务。它的输入通常是模块路径，期望得到的是分层讲解文档。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。</p> <p>这篇是最短路径：不追求完美，只求在 10 分钟内让「代码讲解」第一次跑通。</p> <h2 id="准备2-分钟">准备（2 分钟）</h2> <ul> <li>一份真实但已脱敏的模块路径</li> <li>一个支持技能或自定义指令的智能体工具（如 Claude Code、Cursor、GPTs、扣子等任一）</li> <li>一份你认可的分层讲解文档范例（可选，但很有帮助）</li> </ul> <h2 id="第-1-步写最小指令3-分钟">第 1 步：写最小指令（3 分钟）</h2> <div class="highlight"><pre tabindex="0" style="color:#e6edf3;background-color:#0d1117;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>任务：代码讲解 </span></span><span style="display:flex;"><span>输入：模块路径 </span></span><span style="display:flex;"><span>步骤： </span></span><span style="display:flex;"><span>1. 先给模块一句话职责 </span></span><span style="display:flex;"><span>2. 画出数据流 </span></span><span style="display:flex;"><span>3. 逐个讲关键函数 </span></span><span style="display:flex;"><span>4. 列出常见修改入口 </span></span><span style="display:flex;"><span>输出：分层讲解文档，末尾列出需人工确认的内容。 </span></span><span style="display:flex;"><span>信息不足时先提问，不要编造。 </span></span></code></pre></div><h2 id="第-2-步放到工具里2-分钟">第 2 步：放到工具里（2 分钟）</h2> <p>把上面的内容放进所用工具的规则或技能位置：Claude Code 放进 <code>.claude/skills/code-explainer/SKILL.md</code>（前面补上 name 与 description），Cursor 放进 <code>.cursor/rules/</code>，GPTs 放进 Instructions。具体位置见各平台版本的文章。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-prompt-only/Sun, 18 Oct 2026 00:45:27 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-prompt-only/<p>如果你在代码仓库与终端里反复做代码讲解，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。</p> <p>不是每个人都有能装技能的智能体平台。下面这份提示词可以直接粘贴到任何对话助手中使用，效果接近技能版本，只是需要每次手动粘贴。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-gemini-cli/Sun, 18 Oct 2026 00:39:27 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-gemini-cli/<p>把「代码讲解」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（模块路径），按什么顺序处理，交付什么（分层讲解文档），哪些事不能做。Skill 就是把这些写下来的载体。</p> <p>本文介绍如何在 <strong>Gemini CLI</strong> 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。</p>https://ai.wujiong.cc/posts/2026-10-18-code-explainer-customize/Sun, 18 Oct 2026 00:23:04 +0800https://ai.wujiong.cc/posts/2026-10-18-code-explainer-customize/<p>如果你在代码仓库与终端里反复做代码讲解，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。</p> <p>通用版的「代码讲解」能覆盖大多数情况，但每个团队都有自己的习惯。下面列出最值得调整的几个地方。</p> <h2 id="可调参数一览">可调参数一览</h2> <table> <thead> <tr> <th>参数</th> <th>默认</th> <th>可以怎么改</th> </tr> </thead> <tbody> <tr> <td>输出格式</td> <td>分层讲解文档</td> <td>改成团队模板、表格或固定小标题</td> </tr> <tr> <td>详略程度</td> <td>适中</td> <td>给领导看的精简版 / 给执行者看的详细版</td> </tr> <tr> <td>语气风格</td> <td>中性</td> <td>按团队文风、对外或对内调整</td> </tr> <tr> <td>严格程度</td> <td>标注不确定项</td> <td>提高到“任何推断都要给依据”</td> </tr> <tr> <td>步骤</td> <td>4 步</td> <td>增加团队特有的检查步骤</td> </tr> </tbody> </table> <h2 id="改写示例description">改写示例：description</h2> <p>通用版：</p>