bk-cli aidev 是 bk-cli 中面向蓝鲸 AIDev 的子命令，用于通过命令行调用蓝鲸 AIDev 私有 OpenAPI，完成 AIDev 各类资源的查询与管理。
用途与前置条件 开始调用前必须先读取共享 skill ../bk-cli-shared/SKILL.md。共享 skill 负责认证、context、tenant、stage、dry-run、verbose、header/body 以及通用请求规则；本 skill 只补充 aidev 命令自身的语义与输入约定。调用前需按共享 skill 配置当前 context 的登录凭据，并确保身份具有对应空间和 API 权限。支持 Bearer 鉴权的部署可使用个人 token；使用应用与用户凭据时需同时提供两种身份并申请对应 API 权限。
主要能力 覆盖空间、Skill、MCP、Prompt、智能体、知识库、知识文档、凭证、标签、资源引用与资源集合，以及上传/导入等命令。完整命令列表以 bk-cli aidev --help 为准，单个命令参数以 bk-cli aidev <action> --help 为准。
空间：list_spaces 列出当前身份可访问的空间及 space_id，支持 --keyword 模糊搜索，不授予空间权限。
Skill：list_skills 按空间与关键词筛选并取得 ID；upsert_skill 用已上传制品按 skill_code 创建或更新；get_skill 读取配置（可指定 version）；archive_skill 归档；get_skill_download_url 获取临时下载链接；list_skill_versions 列出版本。
MCP：list_mcps 按空间、mcp_code、mcp_type 列出候选；create_mcp 创建 MCP 配置；get_mcp、get_resource_mcp 读取详情；get_mcp_register_json 获取注册 JSON；get_mcp_by_code 按编码精确解析。
Prompt：list_prompts、upsert_prompt、get_prompt。
智能体：list_agents、create_agent、get_agent（不传 version 返回草稿，传 version 返回已发布版本）、archive_agent、publish_agent、update_agent、append_agent_admins。
知识库：create_knowledgebase、get_knowledge_stats、list_knowledgebases、delete_knowledgebase、update_knowledgebase、query_knowledgebase。
知识文档：create_knowledge、batch_create_knowledges、batch_update_knowledges、batch_delete_knowledges、list_knowledges、preview_knowledge_link、get_knowledge_structure_header、verify_knowledge_link、preview_knowledge、get_knowledge_status、trigger_knowledge_update、list_knowledge_update_frequencies、get_knowledge_index_info、reclean_knowledge、delete_knowledge、update_knowledge、import_knowledge_archive。
凭证：list_credential_types、list_credentials、create_credential、update_credential、batch_delete_credentials、delete_credential、bind_credential、unbind_credential、list_credential_references。
标签与资源引用：list_tags；list_resource_references 查询哪些 Agent 引用了指定资源；list_collections 查找角色 Prompt Collection，upsert_collection 创建或更新。
输入约定与易错点 CLI flag 名保持上游 OpenAPI 参数名不变，例如 space_id、skill_id、mcp_type、agent_code、page_size。list_skills、list_agents 等 GET 列表的 space_id 可省略或传 all；list_knowledges 必须在 body 中传真实空间 ID，不支持 all。带复杂 request body 的 action 统一通过共享 --body '<json>' 传入，执行时要求请求体的 action 会在本地校验 --body 非空；查看请求体结构使用 bk-cli aidev <action> -h --body-schema。upload_file 是文件上传命令，使用 --file、--space_id 和可选 --module 发送 multipart/form-data，不使用 --body。
常用工作流 先用 list_spaces 确认可访问空间并记录目标 space_id；上传 Skill 或知识 ZIP 时先用 upload_file 或 get_upload_url 得到制品地址，再调用 Skill upsert 或知识导入命令；管理 Skill、MCP、Prompt、智能体前先用对应 list_* 定位 ID，写操作优先在测试空间或测试 stage 验证；管理智能体通常按“创建/更新 Agent → 绑定 Skill / MCP / KnowledgeBase → publish_agent 发布”的顺序操作；导入或重建知识后用 get_knowledge_status 或 check_upload_status 查询处理状态；管理凭证时先用 list_credential_types 确认凭证类型，再创建、绑定、解绑或删除。
适用场景与限制 适用于需要以脚本或命令行方式批量查询、同步、维护 AIDev 资源的场景，如资源查重、Agent 配置比对与引用解析、知识制品导入与状态查询、凭证引用评估、删除前影响评估等。publish_agent 返回 pending 或 running 只表示后台处理中，不等于发布或部署完成；import_knowledge_archive 的 anchor_path 必须为 /<知识库ID> 或 /<知识库ID>/<目录>，不能只传 /，提交成功也不等于处理完成。归档、删除、更新等写操作会改变线上资源，应先核对目标 ID 与引用关系。关于收费、价格、支持平台等信息，资料暂未提供。