头脑风暴词云
从这场比赛自己的赛题、评审标准、讨论区和已提交作品,以及本站攻略里提取。字越大,提到越多;大多数 Devpost 黑客松都会写的套话已经去掉。点一个词,看看提到它的往届获奖作品。
关键信息
- 要做什么
- 为 UGREEN AI NAS 开发一个 AI Skill,遵循 Uliya Skill Development Standard:一个 SKILL.md,可选地在 references/ 下附 Markdown 文件,通过已注册的专家智能体调用官方支持的 UGOS CLI 能力。不支持自定义可执行脚本、通用编程运行时,也不支持直接访问 NAS 资源 ↗
- 奖金
- 金奖 $20,000、银奖 $10,000、铜奖 $6,000;另有两个最具创意奖(Most Creative Skills),每个 $5,000,颁给 Innovation & Differentiation 单项得分最高的作品。每个项目只能获得一个奖项 ↗
- 两轮赛制
- 第一轮(10 月 22 日至 11 月 15 日)只看 PDF 和 ZIP,不要求 NAS 运行证据,缺少运行证据本身不会降低得分。随后最多 30 个入围者在 11 月 22 日至 28 日之间各分到一天,远程使用一台 iDX6011 Pro(64GB),并在 11 月 30 日前提交最终包和一段公开的 YouTube 演示视频(不超过 3 分钟)。第一轮分数不带入第二轮 ↗
- 第一轮 PDF
- 回答十个问题,正文合计不超过 500 个英文词:一句话介绍、目标用户和问题、解决方案、核心用户流程、和现有工具相比的实质差异、在哪一步用到哪些 NAS 能力、技术方案、开发进度、两个核心测试加一个边界情况,以及已知限制。还必须列出第三方组件、它们的许可证和外部数据流向 ↗
- 包的限制(来自套件检查器)
- ZIP 不超过 10 MB,单个文件不超过 1 MB,文件总数不超过 100 个。frontmatter 只能有两个字段:name(小写加连字符,2–64 个字符,必须和文件夹名一致)和 description(不超过 1,024 个字符)。references/ 下只能放普通 Markdown 文件,而且每个都要在 SKILL.md 里链接到。正文超过 500 行会出警告 ↗
- 能力目录里有什么
- 我们统计了套件的能力目录(v2.0.0):9 个 CLI,分属 7 个领域(file、album、monitor、document、knowledge、media、music),对应 6 个委托目标(file-agent、photo-agent、security-monitor-agent、document-agent、knowledge-agent、media-agent)。操作共 78 个:47 个只读,27 个会修改状态,4 个两者兼有。51 个无需审批,27 个需要审批:gateway 15 个、workflow 10 个、conditional 2 个。两个播放控制操作会修改状态但无需审批;文档的 translate 和 writing 属于兼有型,但需要审批。ug-photo(18 个操作)和 ug-filesystem(17 个)最大 ↗
- 谁能参赛
- 达到成年年龄的个人,或最多 3 人的团队;组织不能参赛。只有名单内的国家和地区可以参加,例如美国、加拿大(不含魁北克)、欧洲大部分国家、日本、韩国、新加坡、中国香港、中国台湾、巴基斯坦、阿联酋、尼日利亚等。中国大陆、印度、巴西、沙特阿拉伯、越南、乌克兰、孟加拉国和巴拿马都在排除名单中,论坛上有人在问巴拿马是不是被误排除了。动手之前先查名单 ↗
- 语言与原创要求
- 所有材料必须用英文,演示视频要有英文旁白或完整英文字幕。可以沿用以前的想法,但 Skill 和它的核心工作流必须在比赛期间新开发。第二轮必须延续第一轮提交的同一个项目 ↗
- 论坛里未解答的问题
- 有参赛者问:ug-filesystem chtimes 的一次 gateway 审批能不能覆盖整批文件?照片没有 EXIF 日期时,Photos 时间线按哪个日期排?截至 10 月 25 日,我们查看的页面上两个问题都还没有官方回复。如果你的 Skill 依赖这两点,请在 PDF 的已知限制里写明你的假设 ↗
- Skill Rank 的数据
- 2026 年 10 月 25 日 PocketPlay Skill Rank 收录的 932 个智能体技能中,没有一个提到相册、EXIF、Synology 或监控;已有一个 invoice-organizer 在整理发票。所以照片、摄像头事件或媒体库方向的 Skill,比发票、文档整理方向竞争更少 ↗
选题方向
以下是我们给新手的选题建议,依据是四个官方赛道和套件能力目录里实际存在的操作,并非官方命题。
用 ug-photo search-picture 按地点和日期找照片,把数量告诉用户,用户确认后再调用 create-album。这是能力目录里最小的端到端流程,只要一个智能体、两个操作,很适合当第一个 Skill。之后可以再用 vision-ocr 识别车票。
用 ug-surveillance 的 event-timeline、identity-resolve 和 event-evidence(都是只读,无需审批)总结这周谁来过门口,再在用户确认后用 ug-knowledge save-text 保存记录。Skill Rank 的 932 个技能里没有一个涉及摄像头事件。
先用 ug-filesystem ls、ug-filemgr scan-dedupe,用户确认后再用 file-workflow batch-move 移到待审文件夹。套件自带的示例就是这个流程;要做出差异,可以按文件大小报告重复项,扫描返回 no results 时如实报告并停止。
用 ug-filesystem find、ug-document extract 和 ug-filemgr tag-add-file。tag-add-file 是仅有的两个 conditional 审批操作之一,而发票整理已有公开技能,可以加上 ug-document reconcile 核对金额来拉开差距,而不只是分类。
用 ug-photo search-classify 或 vision-vlm 从一次拍摄中初选照片,用 ug-filemgr mediainfo 看视频片段信息,再用 tag-set(gateway)标记选中的素材。先给出编号的候选清单,等用户挑选后再打标签。
先用 ug-video search,再 subtitle-search,只有拿到搜索返回的真实文件 ID 后才调用 subtitle-download(gateway)。套件示例明确提醒不要猜 ID。
相关比赛的往届获奖作品
同主题、已经结束的 Devpost 黑客松里提到本赛关键词的获奖作品,越接近的越靠前。选题前先看几个。
- Codi: Mobile AI Dev Butler Powered by Flutter & Serverpod — Codi turns your phone into a full-stack builder and web automation agent. Chat to create apps or automate tasks - no laptop needed. Built with Flutter + Serverpod for 6B mobile-first users worldwide. (Build your Flutter Butler with Serverpod)
- TICIAN Cierre — Recovers VAT credits for Mexican businesses: processes CFDI, assembles the SAT file, and submits every close to a Vertex AI auditor that approves or rejects it with its reasons. (Build with Gemini XPRIZE)
评审标准
规则:第一轮先做一次通过/不通过的筛选,看项目是否切合主题、是否提出了 AI NAS 方案。通过的项目再按四项等权重标准打分,第二轮用同样的标准评测实际运行的 Skill。同分时先比用户价值(User Value)。最具创意奖只看创新与差异化(Innovation & Differentiation)这一项。 来源 ↗
要有明确的用户问题、清晰的流程、有用的反馈和有意义的结果。用一句话说清用户最后得到什么,比如一个相册、一个整理好的文件夹或一份证据摘要。
和常规 AI 工具相比,要有实质性的新功能、新交互或新流程。两个 $5,000 的最具创意奖只看这一项,所以跨领域组合(比如摄像头事件加文档)可能更有优势。
编排思路合理,正确使用支持的 CLI 和专家智能体,妥善处理权限和错误。落到实处就是:五种委托状态都要处理,要处理空结果,任何修改操作之前都要先让用户确认。
要真正用好 NAS 上的本地数据、存储、算力和隐私优势,而不只是“跑在 NAS 上”。在 PDF 第 6 题里写明每一步用的具体 CLI 操作。
入门技术栈
- UGREEN Hackathon 入门套件 官方页面,提供 UGOS Skill Creation Tool(uliya-skill-kit)。把文件夹放进你的 AI 助手的 skills 目录即可;套件点名支持 WorkBuddy、Claude 和 Codex ↗
- scripts/check-skill.mjs 套件自带的静态检查器:node scripts/check-skill.mjs <你的 Skill 文件夹>。目标是状态显示 static-pass、错误数为 0。需要 Node.js,我们用的是 v20 ↗
- data/capability-catalog.json 列出所有 CLI、操作、效果(只读或修改状态)和审批类型。英文版 v0.7.3 套件的很多描述文字翻译时丢了词,请以字段名和操作名为准 ↗
- 生成期能力依据(Generation-time capability evidence) 检查器只认名为 # Generation-time capability evidence 的标题,行格式必须是 - `ug-photo` → `photo-agent`(带反引号和 → 箭头)。照模板写成 # Capability evidence 加 - cli -> agent,会报 CAPABILITY_EVIDENCE_MISSING 错误。同样,模板里的 # Expert orchestration 标题会报 SKILL_REQUIRED_SECTION_MISSING,检查器要求的是 # Workflow 或 # Orchestration ↗
- delegate 命令 每行一条:delegate --target photo-agent --instruction '...',instruction 用单引号,不能用管道。<path> 这类占位符会触发警告;在父 Skill 里直接调用 cli.invoke 是错误 ↗
- Devpost 项目页 截止前可以一直保存草稿;某一轮提交期结束后,这一轮的内容就锁定了 ↗
时间线
- 报名和第一轮提交开放(9:00 am PT)
- 第一轮截止:提交 PDF + ZIP(11 月 15 日 11:45 pm PT)
- 第一轮评审,至 11 月 19 日 5:00 pm PT
- 最多 30 个入围者收到邮件,内含登录凭据、分配的设备和测试日(12:00 am PT)
- 第二轮开放;每个入围者在 11 月 22 日至 28 日(PT)之间分到一个 NAS 测试日
- 第二轮截止:最终包 + 公开 YouTube 演示(11 月 30 日 11:45 pm PT)
- 第二轮评审:12 月 1 日 10:00 am 至 12 月 5 日 5:00 pm PT
- 约在此时公布获奖名单(2:00 pm PT)
新手怎么做完
- 先确认参赛资格
看规则第 3 节的国家名单。住在被排除地区的人,或者以组织身份参赛,Skill 做得再好也拿不到奖。
- 选一个具体的用户场景
选一个赛道和一个最终成果(一个相册、一个清理好的文件夹、一份摄像头周报),先用一句话写好 PDF 第 1 题,再做别的。
- 对应到真实的操作
打开 data/capability-catalog.json,为每一步写下具体的 CLI 和操作,并标出哪些会修改数据。这些操作需要用户确认,也需要一个 waiting_approval 分支。
- SKILL.md 必须有四个标题
必需的四个一级标题是 # Goal、# Required input、# Workflow(或 # Orchestration)和 # Completion and failure。不要沿用模板里的 # Expert orchestration,检查器不认。再加一节 # Generation-time capability evidence,每个用到的 CLI 写一行 - `cli` → `agent`。
- 处理所有状态和空结果
completed、failed、cancelled、waiting_user、waiting_approval 每个都要写一行,缺一个就报错。凡是搜索或列表类步骤,正文里要出现 "no results"(或 "empty result")这个英文短语。我们实测,写成 "no photos were found" 仍会触发 EMPTY_RESULT_HANDLING_MISSING 警告。
- 避开安全扫描关键词
扫描会逐行检查。只要出现 curl 或 wget,哪怕写的是 "do not use curl",也算错误。skip、bypass、ignore、disable 和 approval、permission、gateway、audit 相距 40 个字符以内也算错误,哪怕写的是 "never skip the approval step",所以要写成 "ask for approval"。在 delegate 行以外,cat、rm、cp、mv 后面跟空格,或出现 /volume1/ 这类路径,同样不通过:我们测试的 "Include the cat photos too" 就被拒了。标注为 bash、python 或 js 的代码块也算错误。
- 反复检查直到 static-pass
运行 node scripts/check-skill.mjs your-skill。我们的 trip-album 测试 Skill 按模板的能力依据格式写,结果是 1 个错误、2 个警告;按上面几点修改后变成 static-pass,0 错误 0 警告。只把 # Workflow 改回模板的 # Expert orchestration,错误就又出现了。打包时 SKILL.md 放在根目录;references/ 只放 SKILL.md 链接到的文件。
- PDF 里如实写开发进度
第 8 题问哪些已实现、哪些要等 NAS 验证,而第一轮不会因为缺少 NAS 证据扣分。写出两个核心测试和一个边界情况(例如相册搜索结果为空),准备在入围测试日录下来。
讨论区
- Track names in the submission form differ from the Official Rules
- Can a Skill save a runtime generated .html file, and can UGOS Files open it?
- Docker containers allowed on NAS? (Alongside a compliant Skill)
- Source Languages
- Three more questions on Skill triggers, write approvals and models
- Static HTML/CSS output via Uliya Skills: Creativity Track
- Three clarifications on Round 1 (image extraction, word limit, video)
- to the team of this hackathon, i have questions that needs answers, i will drop the questions here
- Proposal PDF inclusions
- India excluded by mistake?
- Two technical questions: gateway approval scope and Photos timeline date source
- Panama excluded by mistake or not?