Evidence Planner (实战分镜规划师)
1. 核心目标 (Core Goal)
解决实战中“不知道该截什么图”以及“事后忘记截图”的痛点。 通过预判任务类型,在行动开始前生成一份包含“Must-Have”和“Nice-to-Have”的关键证据 Checkbox 清单。用户在实战过程中只需对照清单“填空”,从而在保持心流的同时完成高质量留证。
2. 触发时机 (Triggers)
- 用户输入关键词:
/shotlist,/plan,分镜表,截图清单。 - 用户准备开始一个复杂的 Debug、功能开发或环境搭建任务时。
3. 输入规范 (Input Specification)
为了生成最精准的分镜表,请提供以下四要素:
- 任务类型 (Action): 如排查、部署、优化、重构。
- 技术栈 (Tech Stack): 如 React, Docker, Kubernetes, Webpack。
- 环境/上下文 (Context): 如 "内网生产环境", "iOS Safari浏览器", "VSCode Remote插件"。
- 具体症状/目标 (Specifics): 如 "内存泄漏", "白屏", "API 502错误"。
✅ 黄金Prompt公式:
Action + Stack + Context + Specifics例子: "我要排查(Action) Linux服务器上(Context) Docker容器(Stack) 频繁OOM重启的问题(Specifics)"
4. 执行流程 (Workflow)
Step 1: 任务嗅探 (Task Sniffing)
分析用户的任务描述,确定任务场景(Bug排查、环境配置、代码重构、性能优化等)。
Step 2: 生成分镜表 (Generation)
基于场景生成结构化清单。
💡 模板资源: 详细的通用模板和各场景示例(Debug、部署、前后端联调)请查阅 templates.md。
核心原则:
- Must-Have (核心证据): 缺失将导致无法复盘的证据(如报错堆栈、关键配置)。
- Nice-to-Have (辅助证据): 丰富上下文的证据(如资源占用、依赖树)。
Step 3: 根据内容输出 (Action)
-
检查上下文:
- 查看
Active Document是否为相关的实战记录/复盘笔记文件。 - 确认用户是否指定了保存路径(默认知识库路径:
e:\OBData\ObsidianDatas\0收集箱日清\)。
- 查看
-
执行动作 (Execute):
- Scenario A: 插入活跃文档 (Insert)
- 若有活跃实战文档,使用代码编辑工具将分镜表插入到文档的开头或“准备阶段”章节。
- Scenario B: 新建知识库文档 (Create)
- 若无活跃文档或用户明确要求保存,则在知识库中创建新文件。
- 命名规范:
{YYYY-MM-DD}-实战分镜-{TaskSkeleton}.md(例如:2024-03-21-实战分镜-Ubuntu服务器配置Clash.md) - 保存位置: 用户指定的目录 或
e:\OBData\ObsidianDatas\0收集箱日清\。 - 工具: 使用
write_to_file工具写入完整的 Markdown 内容。
- Scenario C: 仅输出预览 (Preview)
- 若用户明确仅需查看,直接在聊天窗口输出 Markdown 内容。
- Scenario A: 插入活跃文档 (Insert)
5. 最佳实践 (Best Practices)
- 宁缺毋滥: Must-Have 最好控制在 3-5 项,避免给用户造成心理负担。
- 指令具体: 避免说“截图代码”,要说“截图
main.js中第 15-20 行的异常捕获逻辑”。 - 标记建议: 建议用户使用截图工具(如 Snipaste/ShareX)的高亮功能(红框/箭头)标注重点。