evidence-planner

📁 qingchunwuhui/xianfengaiskills 📅 4 days ago
1
总安装量
1
周安装量
#44415
全站排名
安装命令
npx skills add https://github.com/qingchunwuhui/xianfengaiskills --skill evidence-planner

Agent 安装分布

windsurf 1
amp 1
opencode 1
codex 1
github-copilot 1

Skill 文档

Evidence Planner (实战分镜规划师)

1. 核心目标 (Core Goal)

解决实战中“不知道该截什么图”以及“事后忘记截图”的痛点。 通过预判任务类型,在行动开始前生成一份包含“Must-Have”和“Nice-to-Have”的关键证据 Checkbox 清单。用户在实战过程中只需对照清单“填空”,从而在保持心流的同时完成高质量留证。

2. 触发时机 (Triggers)

  • 用户输入关键词:/shotlist, /plan, 分镜表, 截图清单。
  • 用户准备开始一个复杂的 Debug、功能开发或环境搭建任务时。

3. 输入规范 (Input Specification)

为了生成最精准的分镜表,请提供以下四要素:

  1. 任务类型 (Action): 如排查、部署、优化、重构。
  2. 技术栈 (Tech Stack): 如 React, Docker, Kubernetes, Webpack。
  3. 环境/上下文 (Context): 如 “内网生产环境”, “iOS Safari浏览器”, “VSCode Remote插件”。
  4. 具体症状/目标 (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。

核心原则:

  1. Must-Have (核心证据): 缺失将导致无法复盘的证据(如报错堆栈、关键配置)。
  2. Nice-to-Have (辅助证据): 丰富上下文的证据(如资源占用、依赖树)。

Step 3: 根据内容输出 (Action)

  1. 检查上下文:

    • 查看 Active Document 是否为相关的实战记录/复盘笔记文件。
    • 确认用户是否指定了保存路径(默认知识库路径:e:\OBData\ObsidianDatas\0收集箱日清\)。
  2. 执行动作 (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 内容。

5. 最佳实践 (Best Practices)

  • 宁缺毋滥: Must-Have 最好控制在 3-5 项,避免给用户造成心理负担。
  • 指令具体: 避免说“截图代码”,要说“截图 main.js 中第 15-20 行的异常捕获逻辑”。
  • 标记建议: 建议用户使用截图工具(如 Snipaste/ShareX)的高亮功能(红框/箭头)标注重点。