findscripter 何时使用
当你拿到的是非结构化的缺陷输入——粘贴的报错日志、客服/支持记录、截图或 GIF、语音口述、随手记录的吐槽——需要把它整理成一条干净、开发者拿来即可处理的 GitHub Issue（含摘要、复现步骤、预期 vs 实际、影响等级、证据引用）时使用。
不该用的边界：
- 不是代码评审、方案设计或 PRD/需求文档撰写。
- 产出的 Issue 不能替代环境实测、回归测试或专家复核——它只是把信息结构化，不做验证结论。
- 若缺少必要输入、权限、安全边界或验收标准，停下来向用户追问，不要硬编。
步骤
- 从混乱输入中抽取事实：口述和随手记录里事实往往埋在口语里，逐条拎出来（动作、现象、报错码、时间线）。
- 补全缺失上下文：用户说「同一个项目」「那个 dashboard」时，结合对话/记忆补齐具体名称；确实补不出的留占位符并标注待确认。
- 按下方模板填充各小节，判定影响等级（见指令）。
- 脱敏：项目名、用户 ID、密钥等敏感信息用
[PROJECT_NAME]、[USER_ID]等占位符替换。 - 输出 Issue。如需落盘，存为 Markdown 文件到仓库根的
/issues/目录，命名YYYY-MM-DD-短描述.md。
指令
- 精简无废话：每个字都要有价值，删掉客套与重复。
- 影响等级判定（Severity 对照）：
- Critical：服务宕机、数据丢失、安全问题
- High：核心功能不可用且无绕过方案
- Medium：功能受损但有 workaround
- Low：轻微不便或纯外观问题
- 图片/GIF 引用：内联引用附件，格式
。 - 缺失字段宁可留占位符 + 标注，也不要编造。
输出模板：
## Summary
[一句话描述问题]
## Environment
- **Product/Service**:
- **Region/Version**:
- **Browser/OS**: (如相关)
## Reproduction Steps
1. [步骤]
2. [步骤]
## Expected Behavior
[预期行为]
## Actual Behavior
[实际行为]
## Error Details
```
[报错信息/代码，如有]
```
## Visual Evidence
[附带截图/GIF 的引用]
## Impact
[Severity: Critical/High/Medium/Low + 简要说明]
## Additional Context
[其他相关细节]
示例
输入（语音口述）：
我刚才想部署那个 agent，结果它就静默失败了，没报错啥提示都没有，workflow 跑完了但 agent 直接从列表里消失，刷新重试了三次才成。
输出：
## Summary
Agent 部署静默失败——无报错提示，agent 从列表消失
## Environment
- **Product/Service**: Azure AI Foundry
- **Region/Version**: westus2
## Reproduction Steps
1. 进入 agent 部署页
2. 配置并部署 agent
3. 观察到 workflow 执行完成
4. 查看 agent 列表
## Expected Behavior
Agent 出现在列表中并显示部署状态；部署失败时给出错误提示
## Actual Behavior
Agent 从列表消失，无任何错误信息，需刷新页面重试
## Impact
**High** - 阻断 agent 部署流程，失败时无任何反馈
## Additional Context
重试 3 次后才部署成功
输入（报错粘贴）：
Error: PERMISSION_DENIED when publishing to Teams channel. Code: 403. 昨天还好好的。
输出：
## Summary
向 Teams 频道发布时报 403 PERMISSION_DENIED
## Environment
- **Product/Service**: Copilot Studio → Teams 集成
- **Region/Version**: [REGION]
## Reproduction Steps
1. 为 Teams 频道配置 agent
2. 尝试发布
## Expected Behavior
Agent 成功发布到 Teams 频道
## Actual Behavior
返回 `PERMISSION_DENIED`，状态码 403
## Error Details
```
Error: PERMISSION_DENIED
Code: 403
```
## Impact
**High** - 阻断 Teams 集成，相比此前可用状态属于回归
## Additional Context
昨天还正常，疑似权限/配置变更或服务回归
注意事项
- 影响等级要与真实业务影响匹配，不要为了显眼一律标 High/Critical。
- 敏感数据务必脱敏后再写入 Issue，尤其是粘贴的日志常含 token、内网地址、用户标识。
- 复现步骤要能被他人独立执行；无法复现时明确写出「偶发/无法稳定复现」而非省略。
- 落盘文件名用当天日期（如 2026-06-01）加短描述，便于检索归档。
互见
—
本条采编自 sickn33/antigravity-awesome-skills（MIT）。