@playcraft/skills 0.0.2

package/README.md

@@ -0,0 +1,333 @@
+# PlayCraft Skills 总览
+
+本目录统一管理 PlayCraft 的两类 skill：
+
+| 目录 | 类型 | 说明 |
+|-----|-----|-----|
+| `skills/` | **Atom Skills** | Remix 组装单元（代码/资源/配置）。每个 skill 有 `manifest.json` + `SKILL.md` + `ref/`，命名规范 `<name>.<bundleType>`，如 `phaser.aicomponent`、`win_result_panel.aiimage` |
+| `platform-skills/` | **Platform Skills** | AI Agent 使用 PlayCraft 平台的操作指南（生图、生音频、发布等）。symlink → `packages/backend/src/features/agent/skills/`，修改统一在 backend 进行 |
+
+> **图谱关系**（节点边、权重、组装引擎）后续在 `docs/recommend/` 中单独定义。
+
+---
+
+## 命名规范（必须遵守）
+
+### Atom Skills — `<name>.<bundleType>`
+
+**特征：**
+- 目录名格式：`<snake_case_name>.<bundleType>`（如 `grid_board_layout.aicomponent`、`bg_music.aiaudio`）
+- 必须有 `manifest.json`（声明 atomId、category、tags、bindingRoles、scaffold 等）
+- 必须有 `SKILL.md`（使用说明）
+- 通常有 `ref/` 目录（蒸馏自真实项目的参考代码/资源文件）
+- **代表"是什么"**：一个可组装进 Remix 的具体素材或代码单元
+
+```
+grid_board_layout.aicomponent/   ← Atom Skill
+  ├── manifest.json
+  ├── SKILL.md
+  └── ref/
+      ├── BoardLayout.ts
+      └── BoardLayout3D.ts
+```
+
+### Platform Tools — `playcraft-<name>`
+
+**特征：**
+- 目录名格式：`playcraft-<kebab-case-name>`（如 `playcraft-image-generation`、`playcraft-skill-recommender`）
+- **只有 `SKILL.md`，没有 `manifest.json`**（不参与 Atom Graph，不被 recommend API 索引）
+- **代表"怎么做"**：描述 Agent 如何使用 PlayCraft CLI / API 完成某项操作
+- 被 Agent Skills Loader 发现，在 Agent Session 初始化时加载
+
+```
+playcraft-image-generation/      ← Platform Tool
+  └── SKILL.md                   ← 仅此一个文件
+```
+
+### 判断规则
+
+| 问题 | 是 → | 否 → |
+|------|------|------|
+| 它是一个可以被 scaffold 进项目的代码/资源单元吗？ | Atom Skill（`<name>.<bundleType>`） | → 下一条 |
+| 它描述的是 Agent 如何使用平台工具/CLI 的操作流程吗？ | Platform Tool（`playcraft-<name>`） | 不属于 skills 目录 |
+
+**常见错误：**
+- ❌ 把平台操作指南做成 `manifest.json` + `SKILL.md`（混淆 Atom 和 Platform Tool）
+- ❌ 用 `<name>.aicomponent` 命名平台工具（如 `skill_recommender.aicomponent`）
+- ❌ 给 Platform Tool 创建 `manifest.json`（会被错误地当作 Atom 索引）
+
+---
+
+## Platform Skills 列表
+
+| Skill | 说明 |
+|-------|-----|
+| `playcraft-image-generation` | AI 生图（Google Gemini / IEGG LiteLLM），直接写入文件 |
+| `playcraft-audio-generation` | AI 生音频（BGM + SFX），体积预算管理 |
+| `playcraft-image-processing` | 图片后处理（缩放/裁剪/格式转换/合成）|
+| `playcraft-sprite-sheet` | 多图合并精灵图，输出 PNG + JSON 帧坐标 |
+| `playcraft-sprite-remix` | 精灵图拆解 + 逐帧 AI 重绘 + 重组装 |
+| `sound-effects` | 通过 playcraft CLI 生成音效（SFX）|
+| `playcraft-asset-management` | 查看/替换项目素材 |
+| `playcraft-code-editor` | 读取/修改项目脚本和配置 |
+| `playcraft-remix-workflow` | Remix 工程流程（主题/metadata/schema）|
+| `playcraft-create-remix` | 创建新 Remix 变体 |
+| `playcraft-build` | 在 sandbox 执行 `npm run build` |
+| `playcraft-save` | 将 sandbox 代码 sync → commit → push |
+| `playcraft-deploy` | 组合操作：build → save → publish |
+| `playcraft-project-management` | 查看变体、浏览推荐 Remix |
+| `playcraft-platform-intro` | PlayCraft 平台介绍 |
+| `playcraft-prefab` | playcraft prefab CLI 用法 |
+| `playcraft-skill-recommender` | 构建项目前的 Skill 推荐与脚手架（`playcraft skills match/list/scaffold`） |
+
+---
+
+## bundleType 说明
+
+| bundleType | 含义 | category 可选值 |
+|-----------|-----|--------------|
+| `aicomponent` | 通用代码 skill（引擎/布局/场景/UI/状态/构建/工具） | engine / layout / scene / state / component / build / util |
+| `aigameplay` | 玩法逻辑（PGS schema + 相关代码模块） | gameplay |
+| `aivalidator` | 校验/测试/质量门禁（测试脚本 + 校验报告） | validator |
+| `aiimage` | 图片资源 | visual |
+| `aiaudio` | 音频资源 | audio |
+| `aiconfig` | 配置封包 | config |
+
+---
+
+## Skills 分层清单
+
+### 1. 引擎层（category: engine）
+
+| atomId | 描述 | bindingRoles |
+|--------|-----|-------------|
+| `phaser.aicomponent` | Phaser 3 引擎 + **完整空项目骨架**（7 个文件：HTML/CSS/TS 入口/tsconfig/globals/StartGame/GameConfig），安装后即可 `pnpm dev` 运行 | `gameEngine` |
+
+### 2. 构建层（category: build）
+
+| atomId | 描述 | bindingRoles |
+|--------|-----|-------------|
+| `playable_scripts_build.aicomponent` | 试玩广告多渠道构建管线（@tencent/playable-scripts） | `buildPipeline` |
+| `theme_switcher_build.aicomponent` | 主题入口 `src/theme/index.ts`，构建时切换主题 | — |
+
+### 3. 布局层（category: layout）
+
+| atomId | 描述 | bindingRoles |
+|--------|-----|-------------|
+| `responsive_2d_layout.aicomponent` | **框架无关布局规范**（uiScale/vScale/不变量）+ 默认 Phaser 参考实现 `ref/UiLayout.ts` | `responsiveLayout` |
+| `playable_hud_layout.aicomponent` | **HUD 屏幕分区**（顶/底/棋盘可用高度、z-order 合同），无代码 scaffold | `playableHudLayout` |
+| `playable_end_screen_layout.aicomponent` | **结算全屏布局**（遮罩、安全区、CTA 锚点），无代码 scaffold | `playableEndScreenLayout` |
+| `playable_guidance_layer.aicomponent` | **指引层布局**（挖洞、手指、与 HUD/结算 depth），无代码 scaffold | `playableGuidanceLayout` |
+| `grid_board_layout.aicomponent` | 可变尺寸格子棋盘布局（格子大小/偏移/缩放边界） | `gridBoardLayout` |
+
+### 4. 场景层（category: scene）
+
+| atomId | 描述 | bindingRoles |
+|--------|-----|-------------|
+| `phaser_scene_lifecycle.aicomponent` | Phaser 双场景架构骨架（Preloader → Game） | `sceneLifecycle` |
+| `preloader_scene.aicomponent` | 预加载场景（加载资产 + Loading UI + sdk.start） | `preloaderScene` |
+| `game_scene.aicomponent` | 主游戏场景（协调所有子系统） | `gameMainScene` |
+
+### 5. 状态层（category: state）
+
+| atomId | 描述 | bindingRoles |
+|--------|-----|-------------|
+| `settings_state.aicomponent` | 用户设置（音乐/音效开关/拖拽速度） | `userSettings` |
+| `theme_state.aicomponent` | 主题配置（路径颜色/箭头风格/UI 颜色） | `themeManager` |
+| `level_state.aicomponent` | 关卡进度（当前索引/关卡数据加载） | `levelProgress` |
+| `run_context_state.aicomponent` | 运行上下文（normal/test 模式区分） | `runContext` |
+
+### 6. 玩法层（bundleType: aigameplay / category: gameplay + component）
+
+| atomId | 描述 | bindingRoles |
+|--------|-----|-------------|
+| `path_elimination_rules.aigameplay` | 路径消除玩法 PGS（核心规则 + testCases）；**Remix 的 entry 节点** | `gameplayRule` |
+| `pick_and_match_rules.aigameplay` | 拾取三消玩法 PGS（棋盘拾取→篮子→三同消除）；支持多层堆叠、同类聚合、篮子溢出 | `gameplayRule` |
+| `arrow_path_data_format.aicomponent` | RawLevelJson ↔ ParsedLevel 类型定义和解析器 | `levelDataFormat` |
+| `path_renderer.aicomponent` | 棋盘路径批量渲染器（折线 + 箭头头部） | `pathBatchRenderer` |
+| `path_animation.aicomponent` | 路径动画（消除滑出/阻挡震动/胜利钻石） | `pathAnimationDirector` |
+| `path_input_handler.aicomponent` | 棋盘输入（命中检测/拖拽棋盘/双指缩放） | `boardInputHandler` |
+| `level_lifecycle.aicomponent` | 关卡生命周期（扣命/超时/胜利/进关） | `levelLifecycleController` |
+
+> 旧的 `arrow_escape_core.aigameplay`（描述"放箭头引导角色"玩法）已被 `path_elimination_rules.aigameplay`（路径消除）替代并删除。
+
+### 7. UI 组件层（category: component）
+
+| atomId | 描述 | bindingRoles |
+|--------|-----|-------------|
+| `loading_screen.aicomponent` | Loading 页面 UI（logo/标题/星评/进度 dots） | `loadingScreen` |
+| `top_ui_bar.aicomponent` | 顶部 UI 条容器 + `GAME_TOP_UI_BAR_HEIGHT` 常量 | `topUiBar` |
+| `bottom_ui_bar.aicomponent` | 底部 UI 条占位 + `GAME_BOTTOM_UI_BAR_HEIGHT`（与 `GameConfig` 同源） | `bottomUiBar` |
+| `countdown_timer.aicomponent` | 倒计时显示器（七段数码管风格） | `countdownTimer` |
+| `heart_lives.aicomponent` | 心形生命值指示器 | `livesIndicator` |
+| `combo_display.aicomponent` | 连击计数 UI + 倒计时进度环 | `comboDisplay` |
+| `combo_praise_text.aicomponent` | 连击表扬文案弹出动画（GOOD → LEGENDARY） | `comboPraiseText` |
+| `progress_bar.aicomponent` | 关卡进度条（已消除/总路径） | `progressBar` |
+| `download_button.aicomponent` | 下载 CTA 按钮（呼吸动画 + sdk.install） | `downloadCta` |
+| `game_over_panel.aicomponent` | 胜利/失败结果面板（半透明遮罩 + 结果图 + CTA） | `gameOverDialog` |
+| `tutorial_overlay.aicomponent` | 新手引导浮层（前两关步进式操作指导） | `tutorialOverlay` |
+| `digit_renderer.aicomponent` | 七段数码管数字渲染器（基础组件） | `digitGlyphRenderer` |
+
+### 8. 工具层（category: util）
+
+| atomId | 描述 | bindingRoles |
+|--------|-----|-------------|
+| `sound_utils.aicomponent` | `safePlaySound()` 音频安全播放工具函数 | `audioPlayHelper` |
+
+### 8.5 校验层（bundleType: aivalidator，category: validator）
+
+| atomId | 描述 | bindingRoles |
+|--------|-----|-------------|
+| `gameplay_unit_test.aivalidator` | 玩法逻辑单元测试（Vitest） | `testFramework` |
+| `level_solvability_validator.aivalidator` | 关卡可解性验证器 | `levelValidator` |
+| `level_data_validator.aivalidator` | 关卡数据格式校验器 | `dataValidator` |
+
+> `aivalidator` 与 `aicomponent` 的区别：aivalidator 的核心目的是**检查/验证**已有代码或数据的质量，不产出可部署的功能代码。
+
+### 9. 图片资源层（bundleType: aiimage，category: visual）
+
+| atomId | 对应文件 | bindingRoles |
+|--------|---------|-------------|
+| `direction_arrow_sprite.aiimage`（已有） | `arrows.png` | `directionalIndicator` |
+| `playable_app_logo.aiimage` | `logo.webp` | `appLogo` |
+| `win_result_panel.aiimage` | `win.webp` | `successFeedbackPanel` |
+| `lose_result_panel.aiimage` | `lose.webp` | `failFeedbackPanel` |
+| `nomove_hint_overlay.aiimage` | `nomove_hint.webp` | `dangerFlashOverlay` |
+| `figer_icon.aiimage` | `figer.webp` | `tutorialPointer` |
+| `time_icon.aiimage` | `time.webp` | `clockIcon` |
+| `win_dot.aiimage` | `win_dot.webp` | `winParticleAsset` |
+| `normal_dot.aiimage` | `normal_dot.webp` | `normalParticleAsset` |
+
+> `directionalIndicator` 同类替代簇：`direction_arrow_sprite.aiimage`（箭头）可替换为车、手指、赛博风等变体。
+
+### 10. 音频资源层（bundleType: aiaudio，category: audio）
+
+| atomId | 对应文件 | bindingRoles |
+|--------|---------|-------------|
+| `cheerful_ukulele.aiaudio`（已有） | — | `bgMusic` |
+| `calm_piano.aiaudio`（已有） | — | `bgMusic` |
+| `energetic_electronic.aiaudio`（已有） | — | `bgMusic` |
+| `bg_music.aiaudio` | `bg.mp3` | `bgMusic` |
+| `click_sfx.aiaudio` | `click.mp3` | `sfxClick` |
+| `appear_sfx.aiaudio` | `appear.mp3` | `sfxAppear` |
+| `success_sfx.aiaudio` | `success.mp3` | `sfxSuccess` |
+| `fail_sfx.aiaudio` | `fail.mp3` | `sfxFail` |
+| `lose_sfx.aiaudio` | `lose.mp3` | `sfxLose` |
+| `mistake_sfx.aiaudio` | `mistake.mp3` | `sfxMistake` |
+| `win_anim_sfx.aiaudio` | `win_anim.mp3` | `sfxWinAnim` |
+| `arrow_move_error_sfx.aiaudio` | `arrow_move_error.mp3` | `sfxArrowMoveError` |
+| `button_click_sfx.aiaudio` | `button_click.mp3` | `sfxButtonClick` |
+
+> `bgMusic` 同类替代簇：`bg_music` / `cheerful_ukulele` / `calm_piano` / `energetic_electronic`
+
+### 11. 配置层（bundleType: aiconfig，category: config）
+
+| atomId | 描述 | bindingRoles |
+|--------|-----|-------------|
+| `level_data_pack.aiconfig` | `RawLevelJson[]` 关卡数据集 | `levelDataPack` |
+| `theme_variant.aiconfig` | 主题变体配置（ThemeVariantConfig 实例） | `themeVariantConfig` |
+| `app_metadata.aiconfig` | Loading 页面文案（标题/描述/评分） | `appMetadata` |
+| `easy_to_hard.aiconfig`（已有） | 先易后难难度曲线 | `gameConfig` |
+| `wave_difficulty.aiconfig`（已有） | 波浪难度曲线 | `gameConfig` |
+| `score_goal.aiconfig`（已有） | 分数目标配置 | `gameConfig` |
+| `time_clear_goal.aiconfig`（已有） | 限时通关目标配置 | `gameConfig` |
+
+---
+
+## 继承自 match3 的通用素材
+
+| atomId | 说明 |
+|--------|-----|
+| `match3_core.aigameplay` | match3 玩法规则，暂未改动 |
+| `forest/ocean/castle/desert.aiimage` | 背景图，可作 `boardBackgroundTexture` 候选 |
+| `fruit_tile/jewel_tile/candy_tile.aiimage` | match3 / pick_and_match 可用的瓦片贴图集 |
+
+---
+
+## bindingRoles 语义标签完整列表
+
+语义标签用于：
+1. 声明该 skill 的类别（写在 `bindingRoles` 字段）
+2. 软槽位候选召回（其他 skill 的 `imports[].matchBindingRoles` 引用）
+
+完整枚举见 [`packages/common/src/recommend/atom-graph/types.ts`](../common/src/recommend/atom-graph/types.ts) 中的 `AtomBindingRole` 类型。
+
+---
+
+## 文件结构
+
+```
+packages/skills/
+├── skills/
+│   ├── phaser.aicomponent/
+│   │   ├── manifest.json     # 类型、标签、bindingRoles、scaffold、imports、exports
+│   │   ├── SKILL.md          # 使用说明、Scaffold/Imports/Skill Definition
+│   │   └── ref/              # 蒸馏自真实 remix 的源文件
+│   ├── path_elimination_rules.aigameplay/
+│   │   ├── manifest.json
+│   │   ├── SKILL.md
+│   │   └── ref/
+│   │       └── pgs-schema.json   # 完整 PGS 规则描述
+│   └── ...（共 ~68 个 skill）
+└── test/
+    └── atom-skills.test.ts   # 完整性校验
+```
+
+---
+
+## 双 Skill 系统共存设计
+
+PlayCraft 同时支持两套互补的 Skill 系统，两者职责不同、互不干扰。
+
+```
+.claude/skills/                        ← Claude Code 原生发现路径
+  ├── playcraft-workflow/               ← 静态桥接 skill（随项目模板分发）
+  │   └── SKILL.md                      工作流入口，引导 agent 使用 playcraft skills match
+  ├── playcraft-skill-recommender → …   ← 软连接（playcraft create 自动创建）
+  ├── playcraft-image-generation  → …   ← 软连接（指向 node_modules/@playcraft/skills）
+  ├── playcraft-audio-generation  → …
+  └── …（其余 Platform Tool 软连接）
+
+node_modules/@playcraft/skills/skills/ ← DAG 推荐引擎的 Atom 索引源
+  ├── phaser.aicomponent/
+  ├── match3_core.aigameplay/
+  ├── gameplay_balance_check.aivalidator/
+  └── …（134+ Atom Skills）
+```
+
+### 分层策略
+
+| 层 | 内容 | 发现方式 | 职责 |
+|---|---|---|---|
+| **Claude Code Skills** | 静态桥接 skill + Platform Tool 软连接 | IDE 自动扫描 `.claude/skills/` | HOW：平台工具用法 |
+| **DAG Atom Skills** | 134+ `.aiimage/.aiaudio/.aicomponent/.aigameplay/.aiconfig/.aivalidator` | `playcraft skills match` CLI 推荐 | WHAT：游戏积木 |
+
+### 为什么不把 Atom Skills 放进 `.claude/skills/`
+
+1. **数量问题**：134+ Atom Skills 会淹没 Claude Code 的 description 匹配机制
+2. **格式差异**：Atom Skills 的 SKILL.md 包含 DAG 元数据（`triggers`、`prompt_extension`、`tools`），Claude Code 不解析这些字段
+3. **职责分离**：Atom Skills 通过 `playcraft skills match` 按引擎+意图精准推荐，比 IDE 文本匹配更准确
+4. **发现机制**：DAG 推荐系统可做依赖图遍历、打分排序，远优于 IDE 的关键词匹配
+
+### 桥接 skill（`playcraft-workflow`）的作用
+
+`packages/cli/project-template/.claude/skills/playcraft-workflow/SKILL.md` 是静态提交到模板的唯一 Atom 入口：
+- Claude Code 自动注入（description 含构建相关关键词）
+- 告知 agent "开始任何游戏项目前先运行 `playcraft skills match`"
+- 解释如何阅读 Atom Skill 的 `SKILL.md`（`prompt_extension` / `tools` 字段）
+
+### 软连接生命周期
+
+```
+playcraft create my-game
+  → 复制 project-template（含静态 playcraft-workflow）
+  → 在 .claude/skills/ 创建 playcraft-* 软连接
+    ├── 若 monorepo dev 路径可解析 → 绝对路径软连接（当下即用）
+    └── 否则 → 相对路径软连接（指向 node_modules，npm install 后激活）
+
+npm install
+  → @playcraft/skills 安装到 node_modules
+  → 相对路径软连接自动解析生效
+```
+
+软连接由 `playcraft create` 生成，在 `.gitignore` 中排除，不提交到项目 Git 仓库。

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+export type { Skill, LoadSkillsOptions, LoadSkillsResult, SkillDefinition, RoleDefinition } from './skills.types.js';
+export { loadSkills, loadSkillsFromSandbox, loadSkillsFromDir, formatSkillsForPrompt, parseSkillFrontmatter, parseSkillDefinition, parseRoleDefinition, } from './skills.loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACrH,OAAO,EACL,UAAU,EACV,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,2 @@
+export { loadSkills, loadSkillsFromSandbox, loadSkillsFromDir, formatSkillsForPrompt, parseSkillFrontmatter, parseSkillDefinition, parseRoleDefinition, } from './skills.loader.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/src/skills.loader.d.ts

@@ -0,0 +1,31 @@
+import type { Skill, LoadSkillsOptions, LoadSkillsResult, SkillDefinition } from './skills.types.js';
+/** 从 SKILL.md 内容解析 name、description、triggers（frontmatter）。供 loader 与 ZIP 解析共用。 */
+export declare function parseSkillFrontmatter(content: string): {
+    name: string;
+    description: string;
+    triggers?: string;
+};
+/**
+ * 从 SKILL.md 内容解析能力定义。
+ * 同时支持新格式 `## Skill Definition` 和旧格式 `## Role Definition`（向后兼容）。
+ * 只解析能力字段（tools, prompt_extension），不再解析身份字段。
+ */
+export declare function parseSkillDefinition(content: string): SkillDefinition | undefined;
+/**
+ * @deprecated 向后兼容别名，请使用 parseSkillDefinition
+ */
+export declare function parseRoleDefinition(content: string): SkillDefinition | undefined;
+/** 从沙箱加载 skills */
+export declare function loadSkillsFromSandbox(opts: LoadSkillsOptions): Promise<Skill[]>;
+/** 从本地目录加载 skills */
+export declare function loadSkillsFromDir(dirPath: string): Skill[];
+/** 加载 skills（优先沙箱，fallback 本地）。支持 system + session 两路径合并。 */
+export declare function loadSkills(opts: LoadSkillsOptions): Promise<LoadSkillsResult>;
+/**
+ * Format skills as system prompt section (Discovery phase: name + description only).
+ *
+ * 默认 `_skillsBasePath` 取自共享区（`/mnt/shared/skills`），与 AgentSandboxService.getSkillsPath()
+ * 对齐——skills 是跨用户共享内容，物理上挂在共享区。当调用方显式传入 path 时以传入值为准。
+ */
+export declare function formatSkillsForPrompt(result: LoadSkillsResult, _skillsBasePath?: string): string;
+//# sourceMappingURL=skills.loader.d.ts.map

package/dist/src/skills.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.loader.d.ts","sourceRoot":"","sources":["../../src/skills.loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAgBrG,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAcA;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAiCjF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEhF;AAED,mBAAmB;AACnB,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAoCrF;AAED,qBAAqB;AACrB,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CAgC1D;AAED,6DAA6D;AAC7D,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqCnF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,eAAe,GAAE,MAA6B,GAC7C,MAAM,CAeR"}

package/dist/src/skills.loader.js

@@ -0,0 +1,200 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const SKILL_FILENAME = 'SKILL.md';
+const FALLBACK_SKILLS_DIR = '~/.pi/agent/skills';
+function expandTilde(p) {
+    if (p.startsWith('~/')) {
+        const home = process.env.HOME || process.env.USERPROFILE || '';
+        return path.join(home, p.slice(2));
+    }
+    if (p === '~') {
+        return process.env.HOME || process.env.USERPROFILE || '';
+    }
+    return p;
+}
+/** 从 SKILL.md 内容解析 name、description、triggers（frontmatter）。供 loader 与 ZIP 解析共用。 */
+export function parseSkillFrontmatter(content) {
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!match) {
+        return { name: 'unknown', description: '' };
+    }
+    const block = match[1];
+    const nameMatch = block.match(/name:\s*(.+)/);
+    const descMatch = block.match(/description:\s*(.+)/);
+    const triggersMatch = block.match(/triggers:\s*(.+)/);
+    return {
+        name: nameMatch ? nameMatch[1].trim().replace(/^['"]|['"]$/g, '') : 'unknown',
+        description: descMatch ? descMatch[1].trim().replace(/^['"]|['"]$/g, '').slice(0, 1024) : '',
+        triggers: triggersMatch ? triggersMatch[1].trim().replace(/^['"]|['"]$/g, '').slice(0, 512) : undefined,
+    };
+}
+/**
+ * 从 SKILL.md 内容解析能力定义。
+ * 同时支持新格式 `## Skill Definition` 和旧格式 `## Role Definition`（向后兼容）。
+ * 只解析能力字段（tools, prompt_extension），不再解析身份字段。
+ */
+export function parseSkillDefinition(content) {
+    // Support both new and legacy section headers
+    const sectionMatch = content.match(/## (?:Skill|Role) Definition\s*\n([\s\S]*?)(?=\n##|$)/);
+    if (!sectionMatch)
+        return undefined;
+    const block = sectionMatch[1].trim();
+    // Must have at least tools or prompt_extension to be a valid skill definition
+    // Parse tools list
+    const toolsMatch = block.match(/tools:\s*\n((?:\s+-\s+.+\n?)*)/);
+    const tools = [];
+    if (toolsMatch) {
+        const listText = toolsMatch[1];
+        const items = listText.match(/^\s+-\s+(.+)$/gm) ?? [];
+        for (const item of items) {
+            const val = item.replace(/^\s+-\s+/, '').trim().replace(/^['"]|['"]$/g, '');
+            if (val)
+                tools.push(val);
+        }
+    }
+    // Parse prompt_extension (block scalar)
+    const promptExtMatch = block.match(/prompt_extension:\s*\|\s*\n([\s\S]*?)(?=\n\S|$)/);
+    const prompt_extension = promptExtMatch
+        ? promptExtMatch[1]
+            .split('\n')
+            .map((line) => line.replace(/^  /, ''))
+            .join('\n')
+            .trimEnd()
+        : '';
+    if (tools.length === 0 && !prompt_extension)
+        return undefined;
+    return { tools, prompt_extension };
+}
+/**
+ * @deprecated 向后兼容别名，请使用 parseSkillDefinition
+ */
+export function parseRoleDefinition(content) {
+    return parseSkillDefinition(content);
+}
+/** 从沙箱加载 skills */
+export async function loadSkillsFromSandbox(opts) {
+    const { sandboxId, skillsPath, sandboxClient } = opts;
+    if (!sandboxId || !skillsPath || !sandboxClient)
+        return [];
+    try {
+        const entries = await sandboxClient.listFiles(sandboxId, skillsPath);
+        const skills = [];
+        for (const entry of entries) {
+            const isDir = entry.type === 'dir' || !entry.path.includes('.');
+            if (!isDir)
+                continue;
+            const skillDirPath = `${skillsPath}/${entry.name}`.replace(/\/+/g, '/');
+            const skillFilePath = `${skillDirPath}/${SKILL_FILENAME}`;
+            try {
+                const raw = await sandboxClient.readFile(sandboxId, skillFilePath, { format: 'text' });
+                const content = typeof raw === 'string' ? raw : new TextDecoder().decode(raw);
+                const { name, description, triggers } = parseSkillFrontmatter(content);
+                const skillDefinition = parseSkillDefinition(content);
+                skills.push({
+                    name,
+                    description,
+                    ...(triggers ? { triggers } : {}),
+                    filePath: skillFilePath,
+                    ...(skillDefinition ? { skillDefinition, roleDefinition: skillDefinition } : {}),
+                });
+            }
+            catch {
+                // 跳过无法读取的 SKILL.md
+            }
+        }
+        return skills;
+    }
+    catch {
+        return [];
+    }
+}
+/** 从本地目录加载 skills */
+export function loadSkillsFromDir(dirPath) {
+    const expanded = expandTilde(dirPath.trim());
+    if (!fs.existsSync(expanded) || !fs.statSync(expanded).isDirectory()) {
+        return [];
+    }
+    const skills = [];
+    const entries = fs.readdirSync(expanded, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const skillFilePath = path.join(expanded, entry.name, SKILL_FILENAME);
+        if (!fs.existsSync(skillFilePath))
+            continue;
+        try {
+            const content = fs.readFileSync(skillFilePath, 'utf-8');
+            const { name, description, triggers } = parseSkillFrontmatter(content);
+            const skillDefinition = parseSkillDefinition(content);
+            skills.push({
+                name,
+                description,
+                ...(triggers ? { triggers } : {}),
+                filePath: skillFilePath,
+                ...(skillDefinition ? { skillDefinition, roleDefinition: skillDefinition } : {}),
+            });
+        }
+        catch {
+            // 跳过无法读取的 SKILL.md
+        }
+    }
+    return skills;
+}
+/** 加载 skills（优先沙箱，fallback 本地）。支持 system + session 两路径合并。 */
+export async function loadSkills(opts) {
+    const sandboxSkills = [];
+    if (opts.skillsPath && opts.sandboxId && opts.sandboxClient) {
+        const system = await loadSkillsFromSandbox({ ...opts, skillsPath: opts.skillsPath });
+        sandboxSkills.push(...system);
+    }
+    if (opts.sessionSkillsPath && opts.sandboxId && opts.sandboxClient) {
+        const session = await loadSkillsFromSandbox({ ...opts, skillsPath: opts.sessionSkillsPath });
+        const seen = new Set(sandboxSkills.map((s) => s.name));
+        for (const s of session) {
+            if (!seen.has(s.name)) {
+                seen.add(s.name);
+                sandboxSkills.push(s);
+            }
+        }
+    }
+    if (sandboxSkills.length > 0) {
+        return { skills: sandboxSkills, source: 'sandbox' };
+    }
+    const localPaths = opts.skillPaths ?? [];
+    const envPaths = process.env.AGENT_SKILLS_PATHS?.split(',').map((p) => p.trim()).filter(Boolean) ?? [];
+    const allPaths = [...new Set([...localPaths, ...envPaths, expandTilde(FALLBACK_SKILLS_DIR)])];
+    const seen = new Set();
+    const skills = [];
+    for (const p of allPaths) {
+        const fromDir = loadSkillsFromDir(p);
+        for (const s of fromDir) {
+            if (!seen.has(s.name)) {
+                seen.add(s.name);
+                skills.push(s);
+            }
+        }
+    }
+    return { skills, source: 'local' };
+}
+/**
+ * Format skills as system prompt section (Discovery phase: name + description only).
+ *
+ * 默认 `_skillsBasePath` 取自共享区（`/mnt/shared/skills`），与 AgentSandboxService.getSkillsPath()
+ * 对齐——skills 是跨用户共享内容，物理上挂在共享区。当调用方显式传入 path 时以传入值为准。
+ */
+export function formatSkillsForPrompt(result, _skillsBasePath = '/mnt/shared/skills') {
+    if (result.skills.length === 0)
+        return '';
+    const lines = [
+        '',
+        '## Available Skills',
+        'Use `search_skills` to find relevant skills by keyword before loading. Use `loadSkill` to load a skill when the user\'s request matches:',
+        '',
+        ...result.skills.map((s) => {
+            return `- **${s.name}**: ${s.description || '(no description)'}`;
+        }),
+        '',
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=skills.loader.js.map

package/dist/src/skills.loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.loader.js","sourceRoot":"","sources":["../../src/skills.loader.ts"],"names":[],"mappings":"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"}

package/dist/src/skills.types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Skills 类型定义
+ * pi-skills 标准格式
+ *
+ * 注意：身份字段（role_title, name_pool, avatar, slogan, role_description）已移至
+ * agent_roles 数据库表。SkillDefinition 仅保留能力字段。
+ */
+/** @deprecated 向后兼容别名，请使用 SkillDefinition */
+export type RoleDefinition = SkillDefinition;
+export type SkillDefinition = {
+    tools: string[];
+    prompt_extension: string;
+};
+export type Skill = {
+    name: string;
+    description: string;
+    /** 触发词：用于 search_skills 匹配，逗号/空格分隔，如 "做游戏,创建,打砖块" */
+    triggers?: string;
+    filePath?: string;
+    skillDefinition?: SkillDefinition;
+    /** @deprecated 请使用 skillDefinition */
+    roleDefinition?: SkillDefinition;
+};
+export type LoadSkillsOptions = {
+    sandboxId?: string | null;
+    skillsPath?: string;
+    sessionSkillsPath?: string;
+    skillPaths?: string[];
+    sandboxClient?: {
+        listFiles(sandboxId: string, path: string): Promise<Array<{
+            name: string;
+            path: string;
+            type?: string;
+        }>>;
+        readFile(sandboxId: string, path: string, opts?: {
+            format?: string;
+        }): Promise<string | Uint8Array>;
+    };
+};
+export type LoadSkillsResult = {
+    skills: Skill[];
+    source: 'sandbox' | 'local';
+};
+//# sourceMappingURL=skills.types.d.ts.map

package/dist/src/skills.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.types.d.ts","sourceRoot":"","sources":["../../src/skills.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC;AAE7C,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,sCAAsC;IACtC,cAAc,CAAC,EAAE,eAAe,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE;QACd,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC,CAAC;QAC1G,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;KACrG,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;CAC7B,CAAC"}

package/dist/src/skills.types.js

@@ -0,0 +1,9 @@
+/**
+ * Skills 类型定义
+ * pi-skills 标准格式
+ *
+ * 注意：身份字段（role_title, name_pool, avatar, slogan, role_description）已移至
+ * agent_roles 数据库表。SkillDefinition 仅保留能力字段。
+ */
+export {};
+//# sourceMappingURL=skills.types.js.map