Trae CN 完整版 Skill 脚手架（含全部可选子目录）
适配：Trae CN 国内版 | 包含：主技能文件 + scripts脚本目录 + references参考目录 + assets模板目录
特性：完全官方规范、可直接生效、可自定义扩展、适配懒加载运行机制
一、完整标准目录结构（最终成品）
放置位置：项目级（推荐）项目根目录/\.trae/skills/你的技能名/
your-skill-name/ ├── SKILL.md # 【核心必选】技能主规则文件 ├── scripts/ # 【可选】可执行脚本目录 │ └── tool_helper.py # 示例：Python工具脚本 ├── references/ # 【可选】参考规范、文档、标准 │ └── rule_spec.md # 示例：技能依赖规范文档 └── assets/ # 【可选】模板、示例、固定输出模板 └── output_template.md # 示例：统一输出结果模板二、核心文件：SKILL.md（完整版规范模板）
路径：your\-skill\-name/SKILL\.md，Trae CN 唯一识别主文件
--- name: your-skill-name description: 在这里写技能核心能力，一句话精准概括（用于AI语义匹配触发） globs: ["**/*.py", "**/*.js", "**/*.ts", "**/*.vue"] version: 1.0.0 author: custom --- # 技能中文名称 ## 适用场景 When - 明确列出本技能的触发场景 - 精准、具体、不模糊 - 对应日常开发高频需求场景 ## 禁止场景 Not When - 不属于本技能处理的场景 - 避免技能误触发、错执行 - 一次性临时调试、无规范需求的任务不处理 ## 前置依赖 Precondition - 如需调用 scripts 脚本：确保脚本文件存在可执行 - 如需参考规范：优先读取 references 目录规范 - 如需固定格式：优先套用 assets 模板 ## 执行步骤 Steps（严格顺序、祈使句、无跳跃） 1. 读取用户需求与当前项目文件上下文 2. 按需加载 references 参考规范约束执行逻辑 3. 按需调用 scripts 工具脚本进行数据处理、解析、校验 4. 按照标准逻辑完成核心任务处理 5. 套用 assets 输出模板格式化最终结果 6. 输出结果、给出优化建议、标注注意事项 ## 输出规范 Output 严格按照固定模板输出，结构固定、格式统一： ### 执行结果 - 处理状态：成功/待优化/存在问题 - 核心结论：一句话总结结果 ### 详细内容 此处填充完整执行内容、代码、说明 ### 优化建议 针对性给出可落地的改进方案 ## 特殊规则 Rule 1. 本技能为懒加载触发，仅语义匹配命中后加载全部规则 2. 优先使用目录内脚本与模板，保证输出统一 3. 所有操作必须符合当前项目代码规范 4. 禁止输出模糊、无落地性的内容三、scripts/ 脚本目录（示例通用工具脚本）
路径：scripts/tool\_helper\.py，用于 AI 自动调用、辅助处理逻辑、解析数据
#!/usr/bin/env python3# Trae CN Skill 辅助工具脚本# 存放位置：scripts/ 目录，AI 可按需自动调用importsysimportjsondefskill_data_handler(input_data:str)->dict:""" 通用数据处理工具 可根据技能场景自定义：解析、校验、格式化、统计数据 """result={"success":True,"input_len":len(input_data),"process_msg":"脚本处理完成","data":input_data.strip()}returnresultif__name__=="__main__":# 接收AI传入的参数，输出结构化结果stdin_data=sys.stdin.read()res=skill_data_handler(stdin_data)print(json.dumps(res,ensure_ascii=False,indent=2))四、references/ 参考规范目录
路径：references/rule\_spec\.md，存放技能执行依赖的规范、标准、约束、行业规则
# 技能执行参考规范 ## 概述 本文档为当前 Skill 的执行约束标准，AI 执行时必须严格遵守。 ## 代码规范约束 1. 代码必须具备可读性、可维护性 2. 必须补充必要注释，复杂逻辑增加说明 3. 优先使用项目已有工具类、公共方法 ## 输出约束 1. 输出结构固定，不可随意删减模块 2. 问题必须精准定位，给出具体行号、原因、方案 3. 修复代码可直接复制运行，无报错 ## 执行约束 1. 禁止过度修改原有业务逻辑 2. 优先兼容原有代码风格 3. 所有优化必须正向提升代码质量五、assets/ 模板资源目录
路径：assets/output\_template\.md，固定输出模板，保证每次 AI 输出格式统一、不乱飘
# 技能执行结果模板 ## 执行状态 【成功/待优化/异常】 ## 核心总结 此处填写本次任务的核心结论、关键问题、核心成果 ## 详细处理内容 ### 问题/内容说明 ### 解决方案/成果展示 ```code ``` ## 后续建议 1. 2. 3六、Trae CN 专属运行逻辑说明（适配本结构）
1. 懒加载机制
- 启动只加载 SKILL.md 头部元数据（name/desc/globs）
- 触发命中后 → 加载完整 SKILL.md 规则
- 需要脚本/规范/模板时 → 才加载 scripts / references / assets 内容，极致省 Token
2. 目录优先级
- 规则优先读 SKILL.md
- 工具优先读 scripts 脚本
- 约束优先读 references 规范
- 输出优先套用 assets 模板
七、使用须知（硬性规则）
- 所有目录按需启用：不用可以直接删除文件夹，不影响技能运行
- 文件夹名固定：scripts / references / assets 不可改名
- 技能主文件必须是：SKILL.md（大小写严格）
- 技能名必须：小写 + 中划线，无中文、无大写
（注：文档部分内容可能由 AI 生成）
