Skip to content

lgy1027/specflow-agent-pack / skills/probe

帮 FDE、产品经理和研发团队在投入实现前基于证据做决策:澄清用户问题、比较相关方案、识别可行性风险,并选择最小有效下一步。适用于需求探索、机会评估、竞品/参考调研和方案验证;AI 与智能硬件是专项支持场景,不是使用前提。

references/interrogation-library.md

View on GitHub
# SpecFlow 需求追问与形态探测话术库

以下是可选追问示例,不是标准问卷。`/probe` 先从用户话语和可访问资料中寻找答案,只问会改变方案、验收或风险的未知项;不要逐项照抄,也不要把示例数字当默认值。

这些选项用于帮助 Agent 理清不同回答会怎样改变决策,默认改写成简短的文本问题,不要直接把 `[A]/[B]` 转成可点击卡片。只有运行时能明确返回已提交状态和对应选项值时才用卡片;否则未回答/跳过都继续保持 `Unknown`,并请用户用文本补充。

---

## 场景 1:需求过于简略(一句话脑洞)
> **示例输入**:“想给系统加个大模型能力,把用户上传的文件自动分析一下。”

### 按需澄清的问题(优先问会改变方案的未知项;不要把示例当默认事实)
1. **触发与等待方式**:
   - [A] 用户在前端页面实时等结果(文件大小与可接受时延待确认)
   - [B] 用户上传后后台排队处理(文件可能达几十兆,通过邮件/飞书/通知中心告知结果)
2. **输出交付形态**:
   - [A] 页面结构化卡片与原文定位/引用
   - [B] 生成一份独立的 PDF/Markdown 摘要报告供下载
   - [C] 直接写入数据库,供下游业务系统拉取
3. **试点与决策**:
   - 用什么业务结果判断有价值?观察窗口和最小样本量由谁确认?不达标时有哪些降级、关闭、回滚或退场选项?

---

## 场景 2:存在严重算力/显存风险(算力盲区)
> **示例输入**:“让大模型实时监听视频流,秒级判断画面里有没有违规行为。”

### 按风险选问
1. **推理环境位置**:
   - [A] 纯端侧/边缘设备(如 NAS、Jetson、本地工控机;实际资源和部署约束需取证)
   - [B] 云端高配 GPU 服务器集群(支持并发高算力吞吐)
2. **降级妥协方案**:
   - [A] 关键帧抽样分析(抽样频率需由业务漏检容忍度与压测结果确定)
   - [B] 纯轻量级小模型(YOLO/端侧小目标检测)做前置过滤,可疑画面再上大模型

---

## 场景 3:包含破坏性操作(未设防)
> **示例输入**:“根据会议内容,自动帮所有人创建工单并直接派发到 Jira/飞书任务。”

### 按风险选问
1. **执行确认机制**:
   - [A] 生成草稿,由有权限的用户确认后派单
   - [B] 在有明确风险评估、业务授权、可审计与可回滚机制时,讨论受限自动执行;单一置信度分数不足以作为授权依据
2. **误操作回滚方案**:
   - 若发生大模型幻觉导致误派单或误修改,系统是否具备一键批量撤回能力?

---

## 场景 4:后台批处理与长任务(形态确认)
> **示例输入**:“把过去一年的客户投诉记录全部跑一遍,聚类出共性问题。”

### 按风险选问
1. **任务管理机制**:
   - [A] 提供带进度与阶段追踪的控制看板(适合需要人工观测/干预的任务)
   - [B] 纯后台脚本定时触发,执行完毕后向管理员推送汇总卡片
2. **失败重试策略**:
   - 单条记录因格式损坏解析失败时,应选择:
     - [A] 跳过该条记录并记录至失败队列,是否可行取决于业务一致性要求
     - [B] 整体事务回滚并报错中断

---

## 场景 5:传感器与边缘 AI POC(只在相关时读取)
> **示例输入**:“用毫米波雷达做睡眠分析,再用麦克风识别鼾声/噪声,AI 团队能不能接 POC?”

先分清对方说的 POC 是交互演示、离线数据可行性验证、目标设备实测,还是受控现场验证;这些阶段提供的证据不同。不要把模拟 Demo 当成算法效果证据。

按决策需要逐项澄清,不要一次照抄成问卷:

1. **目标输出**:这次 POC 必须展示/验证什么结果?多个传感器分别产出结果,还是要验证融合结果?先把“睡眠分析”“环境识别”等宽泛词还原成可观察任务。
2. **数据可用性**:是否已有获准用于该 POC 的目标设备数据?若没有,下一步可能是定义采集方案,而不是先承诺模型效果。
3. **数据是否可比较**:若需要融合多路传感器,核实设备/固件版本、时间戳基准、采样/事件对齐、丢包和采集条件;若要评价识别质量,再确认参考标注由谁提供、采用什么判定口径。只在这些问题改变结论时追问细节。
4. **使用场景与影响**:输出用于体验展示、一般状态辅助,还是会影响健康判断/其他高影响决定?涉及敏感数据或高影响用途时,标记授权、隐私和领域责任人为待确认项;不要据此自行作法规结论。
5. **验证边界**:目标设备、部署位置、功耗/延迟等约束是否会影响算法方案?从低成本证据开始,依次考虑数据样本检查、离线回放、目标设备测试,再到受控现场验证;不必默认每个项目都走完整阶段。

样例的来源也要确认:客户实采数据需确认用途授权和脱敏;公共数据需核实许可、设备与任务适配。合成输入可用于内部检查真实算法在合成条件下的预期行为,但不能证明真实用户/现场效果。若输出由固定脚本、stub 或回放生成,只能验证界面/流程,必须标明不是模型结果。来源或授权未知时,不接入该样例。

若目标任务、可用数据或评价参照仍未知,结论应是“可评估/需补证据”,而不是承诺 POC 可行、效果或周期。客户提出的演示日期只作为待评估的期望,不是已验证的工期;没有范围、工作量、资源与依赖依据时,不把该日期写成阶段交付承诺。验收指标和阈值由业务/客户负责人基于目标用途确认,不从示例推导。

首轮问题数有限时可按此顺序筛选,而非一次问完:先确认演示/验收边界,再确认样例数据来源与授权、目标用途/现场;硬件是否可用与算法积累是独立的后续未知,分开核实,不用组合选项代替。不要以未经验证的“几晚样例”当数据量门槛。

样例演示与算法验证要分开:使用合成或获准脱敏数据的 UI/流程演示,可以验证交互和集成假设,但不能当作模型效果证据。若分类结果来自固定脚本、stub 或模拟回放,只能称为模拟流程,不得称为模型实际推理或真实端到端算法管线。单夜或少量 PSG 对齐样本可用于检查格式、同步或管线是否打通;即使项目明确限定为单样本可行性检查,也只能说明该样本上的格式、同步或管线情况,不能据此推断总体性能、泛化能力或项目最低样本门槛。

### 参考依据(供维护者和需要来源的任务使用)

- [NIST AI RMF Playbook — Map](https://airc.nist.gov/airmf-resources/playbook/map/):将预期用途、部署环境、用户、影响和非 AI 替代方案纳入上下文界定;用于支持“先明确任务和场景,再判断是否值得做”的流程,不是合规清单。
- [ROS 2 message_filters 文档源码](https://github.com/ros2/message_filters/blob/rolling/doc/index.rst):展示多路消息按时间戳同步的实现概念。它是 ROS 示例,不代表 SpecFlow 要求使用 ROS;只有存在多流/融合需求时,才把时间基准和对齐方式作为需核实的问题。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall