全局安装的skill

命令安装

使用 -g     skill 默认安装到 ～/.agents/skills 下 并在各支持的ai编程工具全局skills下创建软连接 

— 可能会提示 PromptScript: PromptScript does not support global skill installation   PromptScript不支持全局技能安装。原因：本身不支持全局（-g）技能安装，仅支持项目级安装。但会在各支持的ai编程工具全局skills下创建软连接。满足全局使用需求

可使用 -agent trae-cn  指定安装到 trae cn的全局skill文件夹下，不与其他ai编程软件共享

npx skills add https://github.com/vercel-labs/skills --skill find-skills -g  -y

Find Skills

npx skills add https://github.com/anthropics/skills --skill skill-creator  -g  -y

skill-creator

npx skills add https://github.com/browser-use/browser-use --skill browser-use -g   -y

browser-use

可选安装

示例：skill的git项目地址是  https://github.com/AMap-Web/amap-skills.git  ,实际skill在二级目录下 amap-skills/amap-jsapi-skill  ，可通过二级目录的浏览器地址 https://github.com/AMap-Web/amap-skills/tree/main/amap-jsapi-skill  来使用npx skills 安装并管理，(这个地址不能使用 git clone命令下载)

npx skills add https://github.com/AMap-Web/amap-skills/tree/main/amap-jsapi-skill  -g -y

高德地图 JSAPI v2.0 开发技能

npx skills add https://gitee.com/d2moqi/yudao-cloud-skills.git --skill yudao-cloud-api-developer -g -y

yudao-cloud-api-developer

npx skills add https://gitee.com/d2moqi/yudao-cloud-skills.git --skill yudao-cloud-crud-generator -g -y

yudao-cloud-acrud-generator

npx skills add https://gitee.com/d2moqi/yudao-cloud-skills.git --skill yudao-cloud-vue-builder -g -y

yudao-cloud-vue-component-builder

npx skills add https://gitee.com/d2moqi/yudao-cloud-skills.git --skill yudao-cloud-api-test -g -y

yudao-cloud-api-test

更新skills命令

仅更新全局范围的技能（项目级不更新）：npx skills update -g -y

— 在项目下 执行 npx skills update  -y   可仅更新项目下的skill

删除skills命令

npx skills remove 技能名称 -g

npx skills remove yudao-cloud-api-developer -g

创建skill需要注意

上传到 gitee.com 需要在根目录新建.well-known/skills/index.json ，index.json 内容是skill的定义，可以使用ai来生成

github似乎不需要

全局安装 mcp

命令安装

手动安装

ai编程工具 通过skill/mcp 集成/操作IntelliJ IDEA-CSDN博客

idea-debug mcp和skill

项目中可选安装

mysql  ，可通过trae的mcp市场安装

全局规则

# 1. 始终使用中文回答。

# 2. Skill 调用规则

- 任务启动前检索可用 Skill 列表，按「匹配度 > 可执行性 > 输出增益 > 资源消耗」选型，专用 Skill 优先。

- 单 Skill 无法覆盖时可组合互补 Skill，明确分工顺序；功能重叠仅保留最优项，输出统一整合。

- 需求变更、新增子任务或执行中发现不适配时，立即重新检索并调整选型。

- 用户指定 Skill 优先响应，与需求不匹配时需说明并推荐更优方案，确认后执行。

- 无适配 Skill 时使用原生能力；调用前须读取主控文件，安全规则优先级最高。

# 3. 代码注释约束规则

 **核心原则**：注释解释设计意图、业务背景、边界约束，不复述代码字面逻辑；代码新增/修改时，对应注释必须同步更新，保持一致。

 **强制注释场景**

- 方法级：所有自定义方法生成对应语言标准文档注释；公开方法需包含功能、入参约束、返回规则、异常场景、前置条件

- 业务逻辑：标注需求背景、预期结果、核心处理逻辑、异常分支的业务含义

- 复杂逻辑：算法、并发、状态流转、多层循环，说明设计思路、执行流程、边界条件

- 数据计算：标注字段映射、公式来源、精度舍入规则、异常值处理策略

- 特殊项：魔数、容错降级、第三方依赖/兼容逻辑，说明取值依据与约束

 **豁免范围**

- Java DO/VO/DTO等纯数据载体类（仅字段+get/set），无特殊业务约束时无需类定义注释

- 命名完全自解释的单行极简方法、命名清晰的测试用例，可简化行内注释

 **质量要求**：禁止复述代码的无效注释；关键逻辑块统一注释，避免逐行冗余；表述精准，使用通用术语

 **语言规范**：遵循对应语言官方注释标准（JavaDoc、JSDoc、GoDoc 等）