SuperAPI AI 工具集

cli-doctoring-workflow

办公与效率

查看项目

更新于 10-15 17:29

技能介绍

用途:在设计或审查 CLI doctor、diagnose、preflight、健康检查命令时使用。目标是及早发现常见环境与配置故障,给出精确修复提示,避免用户陷入模糊的排障循环;不应用它把真实错误隐藏在通用帮助文本后,若主命令能直接报错,应先修主命令。

主要能力:围绕受保护的工作流梳理失败链(二进制、版本、配置、凭据、服务、权限、数据等),为每个检查定义 probe、pass、fail、severity、confidence、repair、redaction、timeout 等契约;区分错误与警告,提供人类可读的紧凑分组输出和稳定的 JSON 结构化输出;给出修复提示规则,如优先使用 CLI 自带命令、不打印密钥或敏感头信息、破坏性修复需人工确认;考虑 --json、--verbose、--offline、--network/--deep、--fix、--support-bundle 等模式,默认安全、安静、快速。

使用方式:先命名要保护的工作流,按用户遇到的顺序映射前置条件,选择有明确证据的检查,分类失败,编写修复提示,定义输出模式和退出码语义,并用通过、失败、部分、慢、离线、脱敏等夹具验证。审查时可用提供的审计清单。

适用场景:设计新的 doctor 命令、审计现有健康检查输出、在安装/登录/同步/部署/测试/运行前加入预检查、把反复出现的支持问题转化为检查与修复提示、审查诊断是否泄露敏感数据。

限制:必须确保检查有有用修复提示,否则应考虑是否放入默认运行;网络探测需超时与离线行为;脱敏需测试结构化输出与支持包;退出码应符合 CLI 既有约定;时间戳、路径、主机名、端口等需在比对前归一化。未提供具体实现语言、平台或命令细节。