用途:在完成某个开发阶段后,生成一个简单、隔离、可运行的示例脚本,导入并调用真实实现(非 mock、非伪代码),逐步展示该阶段交付的行为,帮助理解、探索并充当活文档。
主要能力:输出两个文件——可运行脚本 worked-example.{ext} 与配套图文讲解 worked-example.walkthrough.md;若涉及多个概念,则每个概念生成一对文件,并附 README.md 说明运行方式。脚本采用分节叙述结构,每节含说明性块注释、执行代码和带标签的输出,通常 80-150 行、5-8 节。讲解文档使用 mermaid 图(flowchart、sequenceDiagram、stateDiagram-v2、classDiagram、graph 等)按节配图,并给出关键要点表。
使用方式:命令格式为 /plan-6b-worked-example --plan <path> --phase "<Phase N: Title>",也可不带参数从最近上下文自动检测;可选 --focus "<specific aspect>" 缩小到一个概念,--lang <ts|py|go|sh|...> 覆盖语言检测。执行流程包括解析上下文、检测语言、读取阶段产物(tasks.md、execution.log.md、变更源码、spec 与 plan)、编写示例、编写讲解、生成 README、验证可运行并输出摘要。
适用场景:阶段实现后的理解与演示、调试器单步跟踪、团队共享的活文档。
限制:不 mock、不覆盖所有边界情况(测试负责)、不依赖外部服务或数据库、不触发真实副作用(如安装、写盘);若运行失败应修复示例而非实现。资料未提供具体收费、价格、平台支持等信息。