鉴权、签名、限流、一致性、迁移、日志、通知等领域。
为什么做
agent 的能力来自技能和工具
Pi 是运行时，StorageOps 是对象存储专家层。领域技能决定怎么判断问题，扩展工具负责收集有边界的上下文，避免把密钥直接塞进对话里。
它的价值不在于“把错误丢给模型”，而在于问题分类、取证工具、确定性脚本和回归用例共同限定了 agent 的工作方式。
Pi Agent / 对象存储诊断
Pi 的 S3 诊断 agent
StorageOps 给 Pi 装上一套对象存储诊断能力：领域技能、扩展工具、确定性脚本，以及约束输出口径的回归用例。
Pi Agent package
用技能和工具约束诊断
StorageOps 给 Pi 安装一套对象存储诊断能力：诊断技能、扩展工具、确定性脚本，以及用于回归校验的用例。
0115 个诊断技能
覆盖安全、协议兼容、CLI/SDK、性能、网络、生命周期、迁移、一致性、日志、通知和初步分诊。
024 个 Pi 扩展工具
detect_domain · scan_secrets · search_memory · capture_http_trace
03确定性脚本
检查 policy、SigV4、payload hash、ETag、限流、访问日志、迁移估算和端点可达性。
04回归用例
用可复现 case 约束 agent 输出，避免诊断口径漂移。
输入：错误、命令、配置、脱敏日志输出：原因、证据、置信度、下一步检查
内部视角
让 Pi 会诊断对象存储问题
StorageOps 不是一组排查说明，而是一套给 Pi 安装的能力：对象存储诊断技能、扩展工具、确定性脚本和回归用例。
pi extension: storageopsskills + tools loaded
0115 个诊断技能
按鉴权、签名、限流、一致性、迁移、日志等对象存储领域组织。
024 个 Pi 工具
detect_domain、scan_secrets、search_memory、capture_http_trace 负责路由和取证。
03确定性脚本
检查 SigV4、ETag、payload hash、限流、访问日志和端点可达性。
04回归用例
用 golden cases 约束 agent 行为，避免每次修改后诊断口径漂移。
Agent 拓扑
技能决定判断，工具负责取证
StorageOps 的核心不是提示词，而是把 Pi 的诊断过程拆成领域技能、取证工具、确定性脚本和回归评测。
detect_domain、scan_secrets、search_memory、capture_http_trace。
Golden cases 和 size gates 限制输出口径，避免 agent 漂移。
它解决什么
什么时候用
希望让 Pi 排查 S3 兼容故障：AccessDenied、SlowDown、SignatureDoesNotMatch、checksum 异常、生命周期问题或迁移差异。
它不是什么
不是云控制台、存储 SDK 或监控平台。它是给 Pi 安装的一套诊断能力：技能、工具、脚本和路由规则。
安装后有什么
Pi extension、15 个诊断技能包、4 个有界取证工具、托管的 httpmon helper、确定性脚本和回归用例。
技能和工具
诊断技能
覆盖安全、协议兼容、CLI/SDK 行为、性能、网络、生命周期成本、复制、迁移、一致性、日志、通知和初步分诊。
Pi 工具
`scan_secrets`、`detect_domain`、`search_memory`、`capture_http_trace` 负责问题路由和脱敏取证。
辅助脚本
确定性脚本检查 policy、SigV4 输入、payload hash、ETag、限流、访问日志、迁移估算和端点可达性。
回归约束
Golden cases、技能/评测包、size gates 和验证目标让 agent 包保持紧凑、可重复，也更容易安全修改。
诊断流程
启动 Pi
用 `storageops --print` 或交互式 Pi session 输入日志、错误、配置或简短故障描述。
路由技能
`detect_domain` 和技能分类把问题导向鉴权、签名、限流、一致性、生命周期、迁移等领域。
调用工具
Pi 可以扫描密钥、搜索历史 session，或通过托管 httpmon helper 捕获脱敏 HTTP trace。
生成诊断
agent 基于选中的技能和工具输出可能原因、置信度、证据、下一步检查和安全修改建议。
故障领域
对象存储诊断领域
AccessDeniedSlowDownSignatureDoesNotMatchBadDigeststale readslifecycle surprisesfailed notificationsmigration drift
StorageOps 围绕常见 S3 兼容故障组织诊断技能和取证工具，让 Pi 在具体领域内推理，而不是泛泛回答。
问题与用法
为什么说它是 agent，而不是 checklist？
Pi 运行时可以调用 StorageOps 工具、加载领域技能、搜索历史 session，并把确定性 helper 输出和推理结合起来。
一开始应该粘贴什么？
先给完整错误、命令或 SDK 调用、端点形式、相关配置名，以及脱敏后的日志片段。技能和工具会继续收窄证据。
什么时候需要 capture_http_trace？
当诊断依赖 CLI 或 SDK 隐藏的请求细节时使用：headers、redirect、retry、canonical request、payload hash 或服务商响应元数据。