Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/qiniu/skills --skill maas명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | maas |
| description | 七牛云 MaaS 平台管理助手，提供 API Key 管理、用量日志查询等平台运营能力， 并给出标准的需求处理流程（SOP）。 |
| type | tool |
| best_for | ["查询请求日志：按时间/模型/API Key/状态码过滤，获取总量或明细列表","用量统计：按天/小时粒度查询 Token 消耗，按模型分组","API Key 管理：创建、改名、启用/禁用、设限额、删除","生成面板或报表：可用性概览、Token 消耗趋势、Key 配额使用率","生成集成脚本：告警轮询、用量巡检"] |
total（汇总）或取 items（明细）day / hour 等粒度查询 Token 消耗，可按模型分组使用任何接口前，必须先明确凭证类型并严格隔离使用。
MaaS 平台涉及两类相互独立的凭证，混用会导致严重的权限泄露风险：
| 凭证类型 | 形态 | 用途 | 鉴权头格式 | 泄露影响 |
|---|---|---|---|---|
| 平台管理凭证（AK/SK） | AK + SK 两段字符串 | 调用平台管理接口：日志查询、用量统计、Key 管理 | Authorization: Qiniu AK:sig | 可创建/删除所有 Key、读取全量日志用量，极高风险 |
| 模型调用 API Key（sk-xxx） | sk- 开头的单段字符串 | 业务代码调用 AI 模型（OpenAI 兼容接口） | Authorization: Bearer sk-xxx | 仅消耗配额，可通过限额控制，风险可控 |
强制隔离原则：
AK/SK 签名算法详见 references/aksk-token.md，接口完整定义见 references/openapi.json。
以下步骤适用于所有用户需求，必须按顺序执行，不得跳步。
将用户需求对应到上方"提供的能力"中的一项或多项：
若意图不明确，直接询问用户目标，不要猜测并随意调用接口。
缺什么问什么，不要假设后直接执行（时间范围等有明确默认值的除外）：
查询类
管理类（写操作）
429：限流 → 检查该 Key 的配额设置或并发数5xx：服务端错误 → 记录 request_id 上报支持4xx：客户端参数错误 → 查看 errors 字段描述