用途
本技能用于通过 ae-cli 进行渐进式能力发现与通用网关调用。当任务没有对应的领域专用命令时，可用它搜索能力目录、检查能力定义并执行长尾能力。
主要能力
- 列出公司级能力摘要，或某个项目内可用的能力。
- 按关键词搜索能力 ID 与描述（所有词需匹配）。
- 查看指定能力的 input_schema、风险等级、认证、输出与 dry-run 支持情况。
- 可选地校验输入参数（validate）或确认可执行状态（dry-run）。
- 执行能力（run）。
使用方式
命令示例：
# 列出公司级摘要，或某个项目内可用的能力
ae-cli capability list --domain <domain> [--project-id <id>]
# 搜索能力 ID 与描述，所有词需匹配
ae-cli capability search "<terms>" --domain <domain> [--project-id <id>]
# 读取 input_schema、risk、auth、output 与 dry-run 支持
ae-cli capability inspect <capability-id> [--project-id <id>]
# 可选——仅修正参数（网关 /validate）
ae-cli capability validate <capability-id> --input '<json-object>'
# 可选——确认可执行（网关 /dry-run）
ae-cli capability dry-run <capability-id> --input '<json-object>'
# 执行
ae-cli capability run <capability-id> --input '<json-object>'
--input 接受内联 JSON 对象、JSON 文件路径、@<path> 或 -（从 stdin 读取 JSON）。
决策顺序：优先使用领域技能及其专用命令；否则搜索能力目录；构造输入前先 inspect 所选能力；可选地做一次预检查（validate 或 dry-run 二选一，默认不叠加）；最后执行。删除类高风险写操作需在对话中确认。
预检查：validate 与 dry-run
- validate / --validate：在组装复杂 payload 时检查输入结构，不修改业务数据，主要成功字段为 valid、capability_id、normalized_input。
- dry-run / --dry-run：执行前确认（参数 + 风险/输出/取消），不修改业务数据，主要成功字段为 dry_run、capability_id、risk、output_mode、supports_cancel、normalized_input。
同一最终输入默认不要同时运行 validate 和 dry-run；dry-run 已包含参数校验。
风险等级
- read：查询/列表/查看，无需对话确认。
- write：创建、更新、分享等普通写操作，无需对话确认。
- high-risk-write：删除或移除资源，需要对话确认，且 CLI 需 --yes。
旧值 create、update、delete 会归一化为上述三级模型（delete → high-risk-write；create/update → write）。
高风险确认流程
仅当 inspect 显示 risk=high-risk-write 时适用。用户表达意图不等于执行授权。流程：inspect；对复杂删除输入可在起草时用 validate 迭代，最终 payload 用一次 dry-run；同一轮停止，不在 dry-run 同轮调用 run；在对话中汇总能力 ID、project_id、关键输入字段与风险；请用户确认；仅在用户明确授权后，用与 dry-run 相同的输入执行 capability run ... --yes。首次删除尝试绝不传 --yes。
安全
list、search、inspect、validate、dry-run 从不执行业务变更。capability run 在缺少 --yes 时会先检查元数据。只有 high-risk-write 需要在 run --yes 前进行对话确认。
输出
- list 返回 { domain, count, capabilities }。
- search 返回 { domain, query, count, capabilities }。
- inspect、validate、dry-run、run 以标准 ae-cli 信封返回网关数据。
- CREDENTIAL_STORE_UNREADABLE 且 error.type: config 表示本地凭据读取/解密失败，而非服务端认证拒绝；应保留凭据文件并在原 OS 用户/运行时重试，不要自动登录、导入替代 token 或登出。
示例
ae-cli capability search "dashboard list" --domain analysis
ae-cli capability inspect analysis.dashboard.list
ae-cli capability validate metadata.data_table.sql_write --input input.json
ae-cli capability dry-run analysis.folder.delete --input '{"project_id":1,"folder_ids":[1001]}'
ae-cli capability run analysis.dashboard.list --input input.json
限制
不得猜测能力 ID、输入字段、枚举值、资源 ID 或项目 ID。validate 与 dry-run 不要在同一次调用中组合。CLI 终端的 [y/N] 提示在 Agent Bash 中不可用，高风险写操作以对话确认为准。