Skill 文档工具

1. 开发前阅读

参加本活动并使用创建工具开发技能，即表示你已阅读并同意：

• 《UGREEN SkillHub 用户协议》
• 《UGREEN SkillHub 隐私政策》
• 《UGREEN SkillHub 内容安全上架规范》

以上条款以活动页公布版本为准。开发技能时，须同时遵守以上协议与规范。

2. 创作环境准备

请先准备一个 AI 助手，把创建工具装进去。

本工具已在 WorkBuddy、Claude、Codex 中完成适配。为顺利完成本次开发，请优先使用以上助手。其他环境可能暂时无法完整体验本工具。

建议同时准备：

• 能安装技能的上述助手之一
• 一个明确的使用场景
• 本指南提供的官方创建工具压缩包

创建工具会按你的一句话需求生成技能文件，并按规范帮你检查。

3. 安装 UGOS Skill 创建工具

1. 下载本指南提供的官方创建工具，解压后目录名一般为 uliya-skill-kit。
   下载 UGOS Skill 创建工具
2. 把整个 uliya-skill-kit 文件夹放到所用助手的 skills 目录里。不同助手的目录名称可能略有差异，以该助手自己的技能安装说明为准。
3. 重新加载或重启助手后，直接问：
   • 「我能用它做什么？」
   • 「怎么开始做一个绿联 NAS 技能？」
   • 「现在支持哪些能力？」
   能正常回答以上问题，说明工具已经装好。

4. 先想清楚再生成

动手前，建议先写清这四件事。说得越清楚，生成结果越稳：

1. 给谁用：例如家里整理照片的人、要归档合同的人。
2. 什么时候用：用户会怎么说，才应该触发这个技能。
3. 要得到什么：一份清单、一个相册、一段纪要，还是整理后的目录。
4. 不能擅自做什么：找不到就如实说明；删除、移动、覆盖前必须先确认。

5. 创建技能

对助手用一句话说清你想做的事，例如：

• 把下载目录里的重复文件找出来，确认后再整理到归档目录
• 按人物、时间和地点整理去年的旅行照片，做成一个相册
• 把今天的会议录音转成文字，并保存为会议纪要
• 找出今年的合同和发票，抽取关键信息后整理归档
• 查一下这周车库有没有异常，把相关说明整理出来

然后按助手提示确认技能名称，生成技能文件夹。下面用一个完整例子走一遍：

1. 「先不要生成文件。帮我看看：把下载目录里的重复文件找出来，确认后再整理到归档目录。现在支不支持，适不适合做绿联 NAS 技能。」
2. 可行后再说：「帮我做一个技能，就按上面这个需求。」
3. 确认技能名称，例如 download-dedup-archive（建议小写英文和连字符）
4. 「按规范生成技能文件」
5. 「帮我检查一下这个技能」
6. 按提示改完后，再检查一次，直到没有必须修改的问题

生成后的目录通常是：

your-skill-name/
├── SKILL.md         必需，写清做什么、何时用、怎么做、找不到或需确认时怎么处理
├── README.md        建议，用更口语的方式说明适合谁、怎么用
└── references/      可选，补充说明

创建时请注意

• 先想清楚「用户要得到什么结果」，再开始生成
• 只做绿联 NAS 上真实存在的能力，请不要虚构做不到的功能
• 上一步的真实结果才能用到下一步，不要用含糊的「刚才那个目录」代替
• 涉及删除、移动、外发、覆盖等操作时，须等待用户确认
• 找不到结果时如实说明并停止，不要拿相似内容凑数
• 不要在技能里写入账号、密码、密钥等敏感信息
• 不要加入脚本、可执行文件或未说明的外部下载
• 不要残留「待定」、TODO、示例占位文案
• 技能须为你的原创作品，不要搬用未授权的他人技能或核心内容

需要改需求时，直接对助手说「按这个新要求更新技能」，并再次检查。把流程写完整，避免半成品：他人需要能看懂技能从触发到结果怎么走完。

6. UGOS Skill 能力范围

当前可围绕绿联 NAS 的这些能力来创作，我们会持续开放更多，以创建工具压缩包内所提供能力为准。下面是常见方向和组合示例：

也可以把多个方向串起来，例如「先找文件，再读文档，再整理归档」。每一步都要能对应到上面这些真实能力。

不确定某件事能不能做时，直接问助手：

• 「这个能力现在支持吗？」
• 「整理相册和查找文件可以一起做吗？」

以工具内说明为准，不要自行补充清单里没有的能力。

7. 关于技能测试

生成后，按下面三步自测：

1. 用创建工具检查
   对助手说：「帮我检查一下这个技能。」有必须修改的问题，按提示改完后再检查一次，直到没有必须修改的问题。
2. 用户视角通读
   自己把技能从头到尾读一遍：别人能不能看懂解决什么问题、什么时候该用、每一步怎么做、找不到或需要确认时怎么处理。改完可再问助手：「还有哪些地方可以写得更清楚？」
3. 实机测试（决赛阶段）
   按活动页说明，在官方提供的 NAS 实机环境中，用一句真实用户会说的话触发技能，确认能走到你想要的结果。

检查时常见会看到

• 技能名称、说明不完整，或和实际步骤对不上
• 用到了当前不支持的能力
• 高风险操作没有写清「先确认再执行」
• 残留占位文案，或写入了不该出现的敏感信息
• 文件结构、大小或必要说明不符合规范

8. 必要遵守

请完整阅读《Skill 内容安全上架规范》。开发时请特别注意：

• 名称、简介要和真实能力一致，不夸大、不冒充绿联官方
• 不写入密钥、Token，不诱导执行不明代码
• 不越权读取用户未授权的内容，不静默外传数据
• 高风险操作须先告知并等待确认
• 来源和授权要真实，技能须为原创，不搬用未授权的他人内容