feat(general-skills): 通用技能对齐 Agent Skills 官方规范（frontmatter 校验/标准导出/allowed-tools 门控）

[tianling536]

概述

让通用技能(General Skill)的创建/保存/导出全面对齐 Agent Skills 官方规范。此前页面新建技能只是一份裸 Markdown(无 YAML frontmatter、无规范校验、无标准导出),产物在标准工具链里不可用。

规范层(新模块 app/general_skills/standard.py)

• 字段校验:name(1-64,小写字母/数字/连字符,不可首尾/连续连字符)、description(1-1024,做什么+何时用);
• frontmatter 解析与 SKILL.md 组装:可选字段 license / compatibility(≤500) / metadata(键值对) / allowed-tools(空格分隔)全支持;
• name 恒等于 slug(规范硬性要求:name 与父目录名一致);
• 存量无 frontmatter 的技能,读路径(DTO/导出/运行时物化)同样输出规范形态,无需数据迁移。

保存与发布

• /import 与 _create_imported_general_skill(zip/GitHub/clawhub)统一归一化:frontmatter 以表单/解析字段重组(name=slug、可选字段透传、正文保留);
• 校验:新建 slug 不合规 400;导入的第三方不合规名自动 _slugify 清洗;published 缺 description 400(草稿宽限,发布时强制);
• publish 端点发布前强制规范校验;
• 新增 GET /{slug}/export:导出标准 zip(根目录=slug,SKILL.md 为规范化版本)——与既有 zip 导入形成往返。

运行时

• 物化到工作区的 SKILL.md 一律为规范化版本;
• allowed-tools 门控:声明了 allowed-tools 且不含 Bash 时,runner 计划输入仅给 python、计划后再强制校验(生成 bash 即拒绝触发反思重生成);声明 Bash(...) 或未声明则不限制。

前端

• 新建模板换成标准 SKILL.md skeleton(含 frontmatter,并注明由表单生成);
• 基本信息新增 license / compatibility / allowed-tools 三个规范字段(与 frontmatter 同步);
• 文件编辑器支持任意路径(scripts/run.py、references/guide.md、assets/),mime 按扩展名推断;
• 编辑器新增导出技能包按钮(zip 下载)。

验证

• 新增测试:规范层 10 例(name/description 规则、解析组装往返、转义、标准化输出、文件清单、allowed-tools 解析)+ API 层 5 例(保存归一化与可选字段透传、非法 slug/无描述发布 400、草稿宽限、导出 zip 结构断言)+ 运行时 2 例(物化标准化、门控语言列表);
• 存量测试按归一化后的新行为对齐(frontmatter 形态、夹具补 description);
• 全量 1243 passed、ruff 零告警、前端 build 通过、新增文案已入 en.json(本页 i18n 无缺失;i18n:check 报告的 67 条均为 main 预存在,与纯净 main 一致)。

兼容性

• 无 schema 变更;存量技能不迁移,保存/导出/运行时自动规范化;
• 第三方导入(clawhub/GitHub/zip)行为收紧:无 description 的包会被拒绝并给出明确错误(规范必填项)。

编辑器升级(e97b4be 追加)

• 文件面板改目录树:导入/创建多文件技能包后,按路径组织成文件夹层级(scripts/、references/、assets/ 等),文件夹可折叠,文件按层级缩进显示 basename,悬停显示完整路径;右键菜单(重命名/删除)保持不变;
• 新建文件改下拉菜单:预置 scripts/run.py、references/guide.md、assets/data.json 三个规范目录模板(重名自动追加序号),另有"自定义路径…"展开内联输入(回车创建、Esc 收起)——按规范目录结构建技能一步到位。

[hm1229]

感谢您的补充，这里的部分功能我们在新版中已经进行了调整，部分功能为了新版的执行可能不完全兼容，等我们更新稳定后再进行merge

[hm1229]

您好，我们目前已将新版能力进行了更新，方便的话修改后我们继续评审

[tianling536]

已按新版能力完成适配（rebase 到 main 6f72f96,commit 13efe05)，当前 MERGEABLE。逐点说明：

1. 与新版运行时的兼容:runner 的技能包物化保留上游 skill_directories 目录创建，SKILL.md 仍按本 PR 的规范化版本物化（frontmatter 齐全）;allowed-tools 门控（未声明 Bash 则仅 python runtime）在新执行链路上完整保留并复核过调用点。
2. 页面部分对齐上游:main 自带的文件树/新建文件夹/能力范围（capability_scope）全部保留；本 PR 的目录树+新建下拉因与上游实现重复已撤下，只保留独有增量——license/compatibility/allowed-tools 三个规范字段与「导出技能包」按钮。
3. 校验规则与新测试夹具对齐：上游新增测试的导入夹具按规范补了 description(published 必填）。
4. en.json 合入上游新文案，并补齐上游缺的几条翻译（渲染切换/发布到广场等）。

验证：全量 1313 passed、ruff 零告警、前端 build 通过、技能页 i18n 无缺失。

本 PR 当前的独有增量收敛为：规范层（frontmatter 校验/组装/解析）、保存与发布的规范校验、标准 zip 导出、runner 的 allowed-tools 门控与 SKILL.md 规范化物化、页面规范字段与导出按钮。