Skills
一份 SKILL.md：什么时候用、按什么步骤调哪些 API、输出什么、哪些事不能推断。智能体读了就会做。
skills/<name>/SKILL.md
AIDC Developer
为智能体做应用。
一个应用是一组 Skills 加一组 APIs，界面可选。
在 Developer 里做和测，发布到 Nexus——复制一句话给智能体就能用。
$
curl -fsSL https://www.ai-dc.ai/developer/cli/install.sh | sh
帮我接入 AIDC Developer：https://ai-dc.ai/developer/agent-ready.md
9
个 SDK：界面、视觉、语音、视频、模型、建模、语义、自进化、发布
8
个开箱即用的模型，账单记在调用方公司
1
个命令行，智能体与人用同一套
4
种应用形态：只有 Skills、只有 APIs、Skills + APIs、APIs + 界面
一个应用，
一组 Skills 加一组 APIs。
照 OpenAI Plugin 的定义：Skills 教智能体把事做完，APIs 把数据和动作交给智能体与程序，界面只在人需要看和确认的时候才加。
APIs
应用对外提供的查询、读取、动作与工作流运行。HTTP、CLI、MCP 走同一个调用口，以「应用 × 调用人的角色」执行。
POST …/apis/<name>/execute
界面（可选）
给人看、比较、确认、编辑。只调同一套 API——界面能做的，智能体一定也能做。
index.html · ui.css
复制一句话，
不用安装。
每个应用都有一张应用页。登录 AIDC 账号后点「复制给智能体」，把那句话贴给 Adis、Claude Code 或 Codex：它带着你的登录（或开发者 Key）读应用的说明，照 Skills 调 APIs。
帮我用 AIDC 应用「报价工作流」： https://www.ai-dc.ai/nexus/cell-aidc/apps/quote-workflow/about.md
- 打开应用页调用方法、介绍、Skills & APIs、Information，一页看完。
- 复制给智能体一句话加一份说明：APIs、Skills 全文、示例说法和规矩。
- 智能体照做写入先预演，给你看过、你确认了再正式执行。
先做最小的形态。
以后加 API 或界面，不改应用的用途。
SKILLS
只有 Skills
说明加上现成的 AIDC 能力就能把事做完。例：瑕疵检测，Skill 教智能体用视觉检查。
APIS
只有 APIs
API 自己说得清，不需要额外的流程。例：设计中心的初始材料清单。
SKILLS + APIS
Skills + APIs
Skill 带智能体走一套流程，用本应用的 API。例：报价工作流，先预演、再确认。
APIS + UI
APIs + 界面
人要看、比较、编辑、确认。例：企业数据浏览器、审批看板。
九个 SDK，
把企业的能力接进应用。
每个 SDK 先是 API，再是命令行，最后才是界面——智能体能做的事，人也能做。浏览器里一行 import 就能用。
界面
所有应用共用的一套界面：按钮、表单、卡片、表格、对话框、Toast 与刻度轮等加载动效，外观与 shadcn/ui 一致；引一个样式表就能用。
ui.toast("已保存")
视觉
调摄像头、拍照、选图；交给视觉模型做结构化判断，在图上框出问题。
vision.inspect(photo, { task })
语音
边说边出字的实时转写、录音、多语种翻译、会议纪要。
voice.startTranscription()
视频
建立在视觉与语音之上：带声录像、定时抽帧、视频拆帧与音轨分析。
video.analyze(file, { task })
模型
LLM、视觉、转写与调度模型 Jev，OpenAI 兼容；还能把结果交给指定的智能体；账单记在调用方公司。
model.text({ model, messages })
建模
世界模型把文字、照片、视频变成可以走进去的 3D 世界；统一的空间坐标系与锚点，把位置绑到设备与工位——数字孪生的地基。
modeling.generate({ input })
语义
AIDC 的数据平台：数据源、对象与 Action、实时订阅、SQL、访问、自动化、日志与用量都在这里，ERP 永远只读。原来的连接、数据、权限、工作流、日志、账单已并入，旧写法照样能用。
semantic.ontology() · subscribe · automate
自进化
让应用在使用中持续变好：用户直接在应用里说一句「对话框变大」，页面马上变；开发者与智能体把反馈、操作、数据、文件与对话整合成改进提案，一键变成新的语义版本或应用版本。
evolve.mount() · evolve.suggest({ app })
发布
应用清单与 SDK 登记、版本号、test / production 双通道、回滚、应用登记表；每个应用自动生成应用卡片。
aidc app deploy · publish
在 Developer 里做，
在 Nexus 上用。
同一个版本包先进 test 通道给你预览，确认没问题再原样发布到 Nexus——发布的就是测过的那一个，不重新打包。
01 · DEVELOP
开发
aidc app init 生成应用，每个模板都带一条 Skill；写好 Skill 与 API，aidc app check 本地校验。
02 · TEST
测试
aidc app deploy 进 test 通道，打开应用页，复制给智能体试一试。同样的文件重复部署不产生新版本。
03 · DISTRIBUTE
发布
aidc app publish 把测过的版本发到 Nexus 的应用目录。出问题 aidc app rollback 一条命令回退。
企业自己的应用，挂在企业下面
客户开发的应用只对本公司开放：/developer/<公司>/apps/<应用> 给 developer 预览，/nexus/<公司>/apps/<应用> 给全体成员使用。它们跑在沙箱里，拿不到访客的登录态，只能凭平台签发的短时票据调用清单里声明的模型与数据。
# 安装、登录 curl -fsSL https://www.ai-dc.ai/developer/cli/install.sh | sh aidc login # 一条 Skill 的应用：做 → 测 → 发布 aidc app init site-check --template skills aidc app check site-check aidc app deploy site-check # → 应用页，复制给智能体试 aidc app publish site-check # → Nexus 应用目录 # 调别人的应用 aidc app call cell-aidc/quote-workflow run --param rfq_no=RFQ-2609-006 --preview
五个样板，
每个都带 Skills。
都是用这些 SDK 做出来、再用 aidc 发布的应用，打开它们要先登录 AIDC 账号，也都能复制给智能体。报价工作流用虚构的演示数据，访客只能预演；世界模型只展示已生成的世界。源码在 aidc-cloud 仓库的 developer/apps。
给智能体用的，
都是现成的标准。
Claude Code、Codex、AIDH 或任何框架，不装专用插件就能读文档、拿凭证、调模型、用应用、发布应用。
- agent-ready.md：写给智能体的上手说明——一句话交给 Adis，它替你装好、登录、做出第一个应用
- 每个应用的 about.md：复制给智能体的那句话指向它，APIs 与 Skills 全文都在里面
- 每个公司应用一个 MCP 服务器：工具就是它的 APIs，prompts 就是它的 Skills
- llms.txt 文档索引，每页都有 Markdown 原文
- SKILL.md：Agent Skills 格式的操作手册；OpenAPI 3.1 由服务端契约生成
- CLI 全部 --json、从不交互、退出码稳定；发布幂等，出错直接重试
- 所有调用都要先登录 AIDC 账号：member 能调用已发布的应用，部署与发布要 developer；没有匿名调用
# 用一个应用：读说明，照 Skill 调 API $ aidc app about cell-aidc/quote-workflow $ aidc app apis cell-aidc/quote-workflow --json $ aidc app call cell-aidc/quote-workflow run \ --param rfq_no=RFQ-2609-006 --preview --json # 或者接成 MCP 服务器 $ claude mcp add --transport http quote-workflow \ https://www.ai-dc.ai/api/v1/developer/apps/cell-aidc/quote-workflow/mcp \ --header "Authorization: Bearer $AIDC_API_KEY"
同一套开发规范，
AIDC 与客户共用。
AIDC 成员在 Developer 上写的每个模块，客户都能在它之上二次开发。所以规矩只有一套。
API FIRST
先 API 与 CLI
每个能力先有 API，再有命令行，最后才是界面。界面只调同一套 API。
IDEMPOTENT
幂等与预演
发布内容寻址、通道晋升即改指针；所有写操作都能 --dry-run。
REUSE
复用基础设施
登录、计费、限流、模型通道只有一份；ffmpeg、WebRTC 这类公认基础设施直接用，不自研替代品。
VERSIONED
文档与版本
Markdown 单一真源生成文档与 llms.txt；SDK、CLI 同步发版，路径带大版本。
开发者工具链，
在 Developer 里怎样运行。
开发者平台由三类构件组成：接口与 SDK、开发与发布、给智能体用的工具。下面逐项写 Developer 里的每一个构件。
APIs and SDKs · 接口与 SDK
| 构件 | 在 Developer 里是什么 |
|---|---|
Platform APIs | REST：/api/v1/developer/**（应用、版本与通道、Key、登录、数据流、模型、视觉、自进化……）和 /api/v1/models/**（OpenAI 兼容）；Semantic 的接口（对象、SQL、媒体集、文件系统、管理、连接、编排、自动化、应用）也在 /api/v1 下。OpenAPI 3.1 契约公开（含 developer 与 models）。凭证分四种：开发者 Key、应用票据、Agent Key、发布 Key；没有匿名调用。 |
Platform SDKs | 9 个 SDK（界面、视觉、语音、视频、模型、建模、语义、自进化、发布）共用一个版本号，按 URL 分发，浏览器里一行 import 就能用；命令行是同一版本的单个文件。 |
Ontology SDK (OSDK) | TypeScript：semantic.ontology()；Python：客户箱上的智能体用 aidc_semantic（只用标准库）。写法照 OSDK：对象集、聚合、Action、订阅。 |
Build and publish · 开发与发布
| 构件 | 在 Developer 里是什么 |
|---|---|
Developer Console | /developer/console（登录后，只给这家公司的 developer）：首页看应用数、在 Nexus 上的、在测的和 7 天的发布 / 打开 / 错误；Applications 按电脑、手机、智能体、后台四个端筛选，新建向导从公司 Ontology 里选 Object Type 与 Action，第一版直接进 test 通道；每个应用有资源、预览、MCP、文档和指标；Releases 看发布记录；Tokens 看与吊销开发者 Key。 |
Application restrictions | 受限 Agent Key：签发时写明能读的 Object Type、能执行的 Action 和能直传的媒体属性，其余接口一律 403。 |
Bootstrap an application | aidc app init 有 skills、blank、camera、voice、data、semantic、workflow、modeling 八种模板，每个都带一条 Skill 和示例说法；aidc app dev 在本机预览，Key 只留在本机进程里。 |
Hosting an application | aidc app deploy 进 test 通道，在 Developer 预览里验收；aidc app publish 上 production（Nexus）。内容寻址、一个版本号对应一份内容，出问题用 aidc app rollback 回滚。 |
Custom endpoints | 应用的 APIs（query、get、aggregate、action）由同一个调用口 POST …/apis/<name>/execute 暴露给 HTTP、命令行和 MCP，以「应用 × 调用人的角色」执行。 |
Custom widgets | 自带前端的应用可以作为自定义组件嵌进 Semantic 应用的页面；界面统一用界面 SDK（ui.css 与 ui 模块），React 项目用 AIDC UI。 |
Tools for agents · 给智能体用的工具
| 构件 | 在 Developer 里是什么 |
|---|---|
MCP for builders | AIDC Apps Creator：8 个工具（搭脚手架、校验、部署、发布……），让外部宿主里的智能体替你做应用，登录走 OAuth 2.1 + PKCE。 |
Ontology MCP | 每个应用自动是一个 MCP 服务器（POST /api/v1/developer/apps/<ns>/<slug>/mcp）：工具 = 应用的 APIs，prompts = Skills，只在应用声明的范围内读写。 |
同一条产品线，
共用一个底座。
每个产品管一段，用同一套本体、同一套权限、同一批模型。点开任何一个，看它在你们公司里会做什么。
