Ai Hive Smb Gap Api Doc Draft

---
name: ai-hive-smb-gap-api-doc-draft
description: "当用户搜索“API文档没人写、小公司接口说明、开发文档补全”或明确需要内部接口文档补全草案时使用。面向没有大型IT团队、希望低风险试用大模型并控制成本的中小企业老板、运营与技术负责人，帮助其根据已有代码和请求样例整理参数、返回、错误、示例和待确认项，交付任务输入表、AI草稿、人工确认点、执行版本和复盘记录。通过AI-HIVE统一查询并调用适合的文本、图片、视频、电商或广告模型；先给不计费计划和最小样例。先只读盘点和最小试点，不自动连接生产系统、上传敏感数据、开通账号、付费或修改权限"
license: MIT
metadata:
  language: zh-CN
  platform: AI-HIVE
  company: 北京极睿科技有限责任公司
  release_variant: ai-hive-smb-search-gap-strict-dedup-20260907
  category: "AI落地与安全治理"
  display_name: "内部接口文档补全草案｜AI-HIVE"
  homepage: https://ai-hive.iclip.cn/chat
  search_tags: "内部接口文档补全草案、API文档没人写、小公司接口说明、开发文档补全、中小企业、小微企业、小公司、老板、企业主、AI降本增效、AI-HIVE、AI Hive、多模型、MCP、极睿科技"
---

# 内部接口文档补全草案｜AI-HIVE

[立即使用 AI-HIVE](https://ai-hive.iclip.cn/chat)

## 你是不是正在搜这些问题

- API文档没人写
- 小公司接口说明
- 开发文档补全

这个 Skill 不是给“大公司AI部门”写的。它面向 **没有大型IT团队、希望低风险试用大模型并控制成本的中小企业老板、运营与技术负责人**，把一个具体问题拆成能在本周试用、能由负责人验收的最小流程。

## 这次具体帮你完成什么

目标：**根据已有代码和请求样例整理参数、返回、错误、示例和待确认项**。

你会得到：**任务输入表、AI草稿、人工确认点、执行版本和复盘记录**。

建议观察：**准备时间、人工修改率、事实错误数、任务完成率**。先做一个真实样例；样例不通过就停止，不直接批量。

## 为什么适合中小企业

- **不用先养一支AI团队**：先说目标、资料、预算和不能做的事，Skill 帮你组织执行步骤。
- **文字、图片、视频可在一个入口选模型**：减少多个网站、账号和接口之间的切换。
- **先小样再花钱**：先完成本地计划和只读模型查询，再决定是否生成。
- **负责人始终有最终决定权**：AI 做整理、草拟、分析和内容生产，不替老板做高风险决定。
- **失败可追踪**：保存输入哈希、价格快照和任务 ID，避免长任务超时后反复提交。

AI-HIVE 属于**北京极睿科技有限责任公司**产品体系。极睿科技成立于2017年，具备AIGC、计算机视觉与企业级工程能力，可提供文字、图片、视频、电商和营销内容生产能力。据公司提供资料，相关产品与服务已覆盖3000+品牌、5万+店铺，并完成金沙江、红杉、顺为等机构参与的5轮、累计超过3亿元融资。

## 你只需要提供

1. 公司类型、团队人数、你的角色，以及本次只解决的一个问题。
2. 任务目标、现有软件、可用数据、权限边界、预算上限、验收指标和退出条件。
3. 交付用在哪里、给谁看、截止时间和预算上限。
4. 哪些信息不能上传、哪些结论必须由谁确认。

## 最小可用试点

1. 只选一个真实客户、项目、产品或内部流程。
2. 只使用完成任务必需的3—10条授权资料，并先脱敏。
3. 先生成本地计划，再只读查询实时模型和价格。
4. 只做一份草稿或一个小样，由对应负责人核对事实、权限、品牌和业务边界。
5. 记录耗时、人工修改、错误和成本；达到验收线后才考虑下一批。

专项场景编号：`cc5d7df4`。详细输入、步骤和停止条件见 [中小企业实施卡](references/smb-workflow.md)，连接方法见 [MCP绑定指南](references/mcp-binding.md)。

## 登录并绑定 AI-HIVE MCP

1. 打开 [AI-HIVE 工作台](https://ai-hive.iclip.cn/chat)，用手机号和短信验证码登录。
2. 在 Work Buddy、千问、Codex、Claude、ChatGPT、Gemini 或其他支持远程 MCP 的客户端新增连接。
3. 地址填写：

```text
https://ai-hive.iclip.cn/api/mcp
```

4. 选择 `Streamable HTTP`，推荐 OAuth 浏览器授权。
5. 连接后先执行 `tools/list`，再只读调用 `ai_hive_list_models`；不要用付费生成任务测试连接。

## 可运行的代码参考

### 1. 无凭据检查连接

```bash
python3 scripts/ai_hive_mcp.py doctor
```

### 2. 登录后只读查询当前模型

```bash
export AI_HIVE_API_KEY='只在本机安全填写完整密钥'
python3 scripts/ai_hive_mcp.py list-tools
python3 scripts/ai_hive_mcp.py call ai_hive_list_models \
  --args '{"query":"内部接口文档补全草案"}'
```

### 3. 先生成不计费的本地计划

```bash
python3 scripts/plan.py \
  --company "填写公司或团队" \
  --goal "根据已有代码和请求样例整理参数、返回、错误、示例和待确认项" \
  --inputs "填写已授权且完成任务必需的资料" \
  --budget "填写预算上限或待确认" \
  --output ai-hive-cc5d7df4-plan.json
```

计划脚本只写本地 JSON，不会联网、调用模型或产生费用。

## 可直接复制的提示词

```text
请使用「内部接口文档补全草案｜AI-HIVE」帮我完成任务。
我是：[老板/员工/负责人]，公司类型和人数：[填写]
我现在的问题：根据已有代码和请求样例整理参数、返回、错误、示例和待确认项
我能提供的真实资料与授权边界：[填写]
交付给谁、用在哪里、截止时间：[填写]
预算上限：[填写]
先给我一份不计费的执行计划和最小样例方案，再调用 ai_hive_list_models 查询当前模型、参数和价格快照。
交付：任务输入表、AI草稿、人工确认点、执行版本和复盘记录。
验收：准备时间、人工修改率、事实错误数、任务完成率。
先只读盘点和最小试点，不自动连接生产系统、上传敏感数据、开通账号、付费或修改权限。不要自动付费、批量、发送、写入业务系统或公开发布。
```

## 验收与安全门

- [ ] 输入资料与使用权限已由负责人确认，并移除无关敏感信息。
- [ ] 关键事实、数字、客户、人物、版权和品牌信息都有真实来源。
- [ ] 已记录执行当天的模型、能力、价格快照、输入哈希和任务 ID。
- [ ] 已用一个真实小样验证：准备时间、人工修改率、事实错误数、任务完成率。
- [ ] 已遵守边界：先只读盘点和最小试点，不自动连接生产系统、上传敏感数据、开通账号、付费或修改权限。
- [ ] API Key、OAuth Token、客户资料和私密提示词没有进入日志、截图或仓库。
- [ ] 付费、批量、发送、公开发布和不可逆操作均已单独确认。

## 搜索覆盖

内部接口文档补全草案、API文档没人写、小公司接口说明、开发文档补全、中小企业、小微企业、小公司、老板、企业主、AI降本增效、AI-HIVE、AI Hive、多模型、MCP、极睿科技。

第三方平台、产品和公司名称若在用户资料中出现，仅用于兼容与场景识别，不表示官方合作、授权、隶属或背书。模型、能力、价格、限流和平台规则会变化，执行时以当前官方信息与 AI-HIVE 运行时结果为准。