XinJiang/.agents/skills/README.md

技能库说明

本目录包含针对 Three.js 水利三维可视化项目的专用技能，帮助用户系统化处理开发中的常见问题。

可用技能

1. 坐标系转换和3D模型调试 (coordinate-debug)

路径: coordinate-debug/SKILL.md

适用场景:

• 从不同 3D 软件导出的模型坐标系不一致
• 模型出现倒置、朝向错误或位置偏移问题
• 需要调试 3D Tiles 渲染器和水面材质效果

主要功能:

• 系统化识别坐标系问题
• 正确使用转换工具和参数
• 有效调试 3D 模型和渲染效果
• 建立标准化的坐标系处理流程

示例提示语:

• "我的 Blender 模型导入 Three.js 后倒置了，如何解决？"
• "如何调试 3D Tiles 渲染器的坐标系问题？"
• "水面材质显示异常，可能是坐标系问题吗？"

2. Three.js 水利三维项目配置 (project-config)

路径: project-config/SKILL.md

适用场景:

• 新项目初始化和搭建
• 项目依赖管理和更新
• 场景配置和材质参数调整
• 性能优化和调试

主要功能:

• 快速搭建 Three.js 水利三维项目
• 系统化配置场景和材质参数
• 优化项目性能和渲染效果
• 建立标准化的项目配置流程

示例提示语:

• "如何初始化 Three.js 水利三维项目？"
• "如何调整水面材质参数？"
• "如何优化 3D Tiles 渲染性能？"

使用方法

自动调用

当用户提出相关问题时，AI 会自动识别并调用相应的技能。

手动指定

用户可以明确指定使用某个技能：

请使用坐标系转换技能帮我解决模型倒置问题

技能组合

多个技能可以组合使用，例如：

1. 先使用 project-config 初始化项目
2. 再使用 coordinate-debug 解决坐标系问题

技能开发

添加新技能

1. 在 .agents/skills/ 目录下创建新技能目录
2. 编写 SKILL.md 文件，遵循模板格式
3. 在 README.md 中添加技能说明

更新现有技能

1. 编辑对应的 SKILL.md 文件
2. 更新技能描述和示例
3. 测试技能效果

项目结构

.agents/skills/
├── README.md                    # 技能库说明
├── coordinate-debug/
│   └── SKILL.md                 # 坐标系转换和调试技能
└── project-config/
    └── SKILL.md                 # 项目配置技能

相关资源

• 项目文档: README.md - 项目整体说明
• 坐标系说明: 坐标系转换说明.md - 坐标系转换详细说明
• 模型倒置解决方案: 模型上下颠倒解决方案.md - 常见问题解决方案

技能更新记录

2026-06-13

• 创建 coordinate-debug 技能
• 创建 project-config 技能
• 初始化技能库文档