用途:当文档中的代码片段可能与真实实现脱节时使用,帮助同步并校验文档示例。
主要能力:以“症状到动作”的触发条件判断是否需要应用,例如函数签名变化、导入或包名变化、请求或响应契约变化、框架指引或推荐模式变化、文档片段概念上可编译但已与实际代码库不符。
使用方式:工作流为先找到权威实现,再更新文档、示例与 README 中所有受影响的片段,随后验证语法、导入与预期输出,并标注有意的差异(如为教程简化的片段)。支持在 GitHub Copilot、Claude Code 和 Codex 间通用:Copilot 可将文件夹放在可见技能路径或用项目指令包裹;Claude Code 放在本地技能目录或兼容插件源;Codex 需安装或同步到 $CODEX_HOME/skills/code-examples-sync 并在重大变更后重启。无需 MCP;如宿主不支持,可用回退提示词,依赖本地指令、捆绑资源、标准 shell 或编辑器工具及直接验证,并以本地文件、测试、渲染输出、日志或截图作为证据路径。
质量检查:片段匹配当前 API 形态、导入与包名最新、异步与错误处理及初始化步骤仍合理、输出示例符合当前行为、跨文档重复片段被一并更新。
限制与反模式:避免在计划或门槛不清晰时开工、把验证当作可选清理、将规划实现与发布混在一次跳跃中完成。未提供具体命令与安装细节;声称成功前需先满足明确的成功标准、约束与停止条件,并先收集所需证据。