AIDC Developer
Skills
一份 SKILL.md：什么时候用、按什么步骤调哪些 API、输出什么、哪些事不能推断。智能体读了就会做。
skills/<name>/SKILL.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
复制一句话，
不用安装。
每个应用都有一张应用页。点「复制给智能体」，把那句话贴给 Adis、Claude Code 或 Codex：它读应用的说明，照 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-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、从不交互、退出码稳定；发布幂等，出错直接重试
# 用一个应用：读说明，照 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 同步发版，路径带大版本。
