用途:为 CAP(Cloud Application Programming Model)应用的构建与扩展提供正确、精简、符合惯例的指导,覆盖从项目搭建、CDS 建模到声明式注解和编程式事件处理器的全流程,支持 Node.js 与 Java 两种运行时。
主要能力:该 SKILL.md 是一个路由,每个主题独立存放在各自的参考文件中,按需加载。参考文件包括 cds-modeling.md(领域模型与服务投影)、declarative.md(校验、约束、授权等声明式注解)、custom-logic.md(自定义事件处理器,仅在注解无法表达规则时使用)、sample-data.md(用 CLI 生成测试数据)、nodejs.md(CAP Node.js 应用细节)、java.md(CAP Java 应用细节)。
使用方式:新建项目使用全局安装的 @sap/cds-dk,命令如 cds init <name>、cd <name>、cds watch;纯建模可在未定义运行时的情况下直接 cds watch。已知运行时时可给 cds init 传 --java 或 --nodejs。用 cds add <feature>(如 hana、xsuaa、approuter、mta)按需增量添加功能。在为 API 或注解猜测、以及改动现有项目模型之前,应查阅权威 CAP 文档:优先使用 CAP MCP 服务器搜索文档与读取有效 CDS 模型;没有 MCP 时可使用 capire LLM 文档入口 https://cap.cloud.sap/docs/llms.txt、https://cap.cloud.sap/docs/llms-full.txt、https://cap.cloud.sap/docs/sitemap.md,任意页面 URL 后加 .md 可获取 markdown 版;也可用 cds compile <path>(如 cds compile srv --to edmx)查看有效 CDS 模型。推荐工作顺序:建模领域、用投影暴露服务、优先声明式约束、再写处理器、最后生成示例数据。
限制与禁止事项:不要为通用服务提供程序已处理的功能编写处理器;不要硬编码租户 ID、系统 ID 或凭证;不要内联用户可见字符串,应使用 _i18n/ 资源包;不要运行 cds add sample(会生成完整演示应用),仅在用户明确需要最小入门模型时使用 cds add tiny-sample;不要把 CAP 文档当作 Fiori/SAPUI5 的完整参考;发布说明或版本推荐表中的信息可能过时,版本相关结论应以 cds version、npm view 或当前 Getting Started 页面等实时来源交叉核对。运行时的具体禁止事项(如 Node 中在 cds.on('served', ...) 内使用 await)见对应参考文件。