系统化故障定位
用复现、假设、验证、回归的闭环方法排查疑难故障，输出假设树与验证步骤。
本技能分免费能力（本地完成）与付费能力（远端专业规范包）两层，详见「能力与计费」。
触发规则
| 用户意图 | 处理 |
|---|---|
| 直接要做系统化故障定位相关的分析/方案/文书 | 进入完整流程 |
| 只想先梳理思路、不要产出文件 | 只做第 1 步，不发起付费 |
| 已有规范包，直接出交付物 | 跳过付费，直接进入第 3 步 |
| 只问本技能能干嘛 | 仅介绍，不执行任何操作 |
能力与计费
| 能力 | 交付方式 | 计费 |
|---|---|---|
| 目标澄清与要点梳理 | 本地对话完成 | 免费 |
输入结构整理（产出 input.json） |
本地完成 | 免费 |
| 系统化故障定位规范包（判据/基准/结构） | 远端服务按需下发 | ¥1.00 / 次 |
| 结构化交付物生成 | 本地脚本 scripts/apply_spec.py，零依赖 |
含在上述单次费用内 |
- 单次价格：¥1.00（100 分），与远端账单金额、平台展示价保持一致。
- 支付渠道：支付宝 AI 按量付费（402 + Payment-Proof 协议）。
- 一次付费取得一份「系统化故障定位规范包」，同一份规范包可反复用于生成多份交付物，不重复计费。
依赖
| 依赖 | 用途 | 安装 |
|---|---|---|
| Python 3.8+ | 运行本地脚本 | 系统自带 |
alipay-bot |
买家侧官方支付能力 | npx -y @alipay/agent-payment@latest install |
本地脚本只用标准库，不装任何第三方库，离线可跑；仅付费资源获取需联网。
核心准则
- 先梳理后付费：没有明确输入不发起付费，避免花冤枉钱。
- 付费前必须说清：执行
probe后，向用户说明用途、金额（¥1.00）、计费单元，取得明确同意再pay。 - 结论不虚构：交付物中的数值必须来自使用者输入或规范包基准，不得编造。
- 脱敏后再上传：提交给远端的
payload只含结构化参数，不含正文、账号或路径信息。
工作流程
1. 明确目标与输入
问清使用者的目标、范围与已有材料（已说明则跳过），据此确定分析维度与输出结构。
2. 产出输入 JSON
把材料整理为 input.json：
{
"subject": "被分析对象名称",
"items": [
{"name": "条目一", "evidence": "相关描述或数据文本", "value": 0}
]
}
items 为待分析条目；evidence 用于逐维核对，value 供测算类使用。
3. 取得专业规范包（付费）
付费由 scripts/pay_client.py 编排，脚本不接触支付密钥，也不自行实现支付与签名。
# ① probe：请求资源，未付款时取得 402 账单并落盘
python3 scripts/pay_client.py probe --state-dir .state/<SESSION_ID>
# ② pay：把账单交给官方支付能力，等待用户确认付款
python3 scripts/pay_client.py pay --state-dir .state/<SESSION_ID> --session-id <SESSION_ID>
# ③ complete：付款后携凭证重试，取得规范包
python3 scripts/pay_client.py complete --state-dir .state/<SESSION_ID> --proof-file proof.txt
规范包落在 .state/<SESSION_ID>/result.json，取出 data 字段存为 systematic-debug-hckp_spec.json。
服务地址通过环境变量覆盖：export PAY_API_BASE="https://example.com/pay"（占位符，请将其替换为卖家实际提供的付费网关地址；未配置时脚本会连到占位地址并清晰报错，不会静默降级）。
4. 生成交付物
python3 scripts/apply_spec.py --spec systematic-debug-hckp_spec.json --input input.json --out 交付物.md
缺少规范包时脚本会以退出码 3 报错并说明原因，不产出任何文件。
Agent 执行要求
- 先说清后支付：说明用途、¥1.00 单价与计费单元，用户确认后再
pay。 - 原样透传：官方支付能力的输出原样展示，不裁剪、不改写。
- 复用原订单：
complete必须复用 probe 阶段的同一订单，不重新下单、不重复付款。 - 失败如实报告：任一环节失败如实展示并停在当前步骤，不降级为「假装成功」。
输出模板
## 系统化故障定位 · 交付物
对象：… 生成时间：…
| 维度 | 权重 | 核对结果 | 得分 |
|------|------|----------|------|
| … | … | 命中/未命中 | … |
结论：…
建议：
1. …
注意事项
- 规范包内含判据与基准，属于付费内容，请勿外传。
- 本技能只做结构化分析与文书产出，不对事实真实性负责；关键数据须由使用者确认。
- 同一份规范包可重复用于多份交付物，不必每次重新付费。
参考资料
scripts/apply_spec.py— 规范包驱动的交付物生成器（需规范包）scripts/pay_client.py— 付费编排（probe / pay / complete）references/paid-gateway.md— 付费链路（402 / Payment-Needed / Payment-Proof）契约references/systematic-debug-hckp-method.md— 系统化故障定位方法
免责声明
本技能提供的是方法论、结构化模板与本地工具，不替代专业判断；涉及法律、财务、安全、合规等场景请以官方规范与专业人士意见为准。本地脚本只处理使用者提供的输入，付费专业规范包由声明域名下的服务按次下发。
