@vibe-forge/workspace-assets 3.0.0 → 3.1.1-alpha.0

package/__tests__/__snapshots__/workspace-assets-rich.snapshot.json

@@ -467,7 +467,7 @@
       ]
     },
     "options": {
-      "systemPrompt": "<system-prompt>\nThe project system rules are:\n# review\n\n> 必须检查发布改动的回归风险。\n\n# demo/security\n\n> Use when: 插件安全规则\n> Rule file path: node_modules/@vibe-forge/plugin-demo/rules/security.md\n> Only read this rule file when the task matches the scenario above.\n</system-prompt>\n\n\n<system-prompt>\nThe following skill modules are loaded for the project:\n# research\n\n> Skill description: 检索资料\n> Skill file path: .ai/skills/research/SKILL.md\n> Resolve relative paths in the resource content relative to the directory containing this skill file.\n\n<skill-content>\n先阅读 README.md，再补充结论。\n</skill-content>\n</system-prompt>\n\n\n<system-prompt>\nThe project includes the following entities:\n  - architect: 负责拆解方案的实体\n\nWhen solving user problems, you may specify entities through `VibeForge.StartTasks` as needed and have them coordinate multiple entity types to complete the work; use `VibeForge.GetTaskInfo` and `wait` to track progress.\nTask tool guide:\n- Use `VibeForge.StartTasks` to start a new child task when the work should run in a separate entity or workspace, or when it needs to continue independently from the current turn.\n- After starting a task, use `VibeForge.GetTaskInfo` with `{ taskId }` to inspect one task. It is also the right tool when a task seems stalled, failed, or might be waiting for input.\n- By default, `GetTaskInfo` returns the 10 most recent log entries in descending order, so newer entries appear earlier in the `logs` array. Pass `logLimit` to inspect a different number of recent logs, and set `logOrder` to `\"asc\"` when you want the selected log window in oldest-to-newest order.\n- Use `VibeForge.ListTasks` with the same `logLimit` and `logOrder` fields when you need to find a taskId or inspect multiple tasks at once.\n- Use `VibeForge.SendTaskMessage` with `{ taskId, message }` when you need to give a task another instruction. Running tasks continue immediately; completed or failed tasks resume the same conversation instead of forcing a replacement task.\n- Use `VibeForge.SubmitTaskInput` only when `VibeForge.GetTaskInfo` or `VibeForge.ListTasks` shows `pendingInput` or `pendingInteraction`, or the task status is `waiting_input`. Do not use it for ordinary follow-up instructions.\n- If a task is `completed` or `failed` but you want to keep working in that same thread of execution, prefer `VibeForge.SendTaskMessage` to resume it. Start a new task only when you actually want a replacement task.\n- When a task is still making progress, use `wait` between checks instead of repeatedly restarting it.\n</system-prompt>\n\n\n<system-prompt>\nYou are a professional project execution manager who can skillfully direct other entities to work toward your goal. Expectations:\n\n- Never complete code development work alone\n- You must coordinate other developers to complete tasks\n- You must keep them aligned with the goal and verify that their completion reports meet the requirements\n\nChoose the appropriate workflow based on the user's needs and the actual development goal, and use the workflow identifier to locate and load the corresponding definition.\n- Pass the identifier based on the actual need. This is not a path; use the standard workflow loading capability to resolve it.\n- Decide how to pass parameters based on their descriptions and actual usage scenarios.\nThe project includes the following workflows:\n- Workflow name: release\n  - Description: 正式发布流程\n  - Identifier: release\n  - Parameters:\n    - None\n\n- Workflow name: demo/release\n  - Description: 插件发布流程\n  - Identifier: demo/release\n  - Parameters:\n    - None\n\n</system-prompt>\n\n\n执行正式发布，并整理变更摘要。",
+      "systemPrompt": "<system-prompt>\nThe project system rules are:\n# review\n\n> 必须检查发布改动的回归风险。\n\n# demo/security\n\n> Use when: 插件安全规则\n> Rule file path: node_modules/@vibe-forge/plugin-demo/rules/security.md\n> Only read this rule file when the task matches the scenario above.\n</system-prompt>\n\n\n<system-prompt>\nThe following skill modules are loaded for the project:\n# research\n\n> Skill description: 检索资料\n> Skill file path: .ai/skills/research/SKILL.md\n> Resolve relative paths in the resource content relative to the directory containing this skill file.\n\n<skill-content>\n先阅读 README.md，再补充结论。\n</skill-content>\n</system-prompt>\n\n\n<system-prompt>\nThe project includes the following entities:\n  - architect: 负责拆解方案的实体\n\nWhen solving user problems, you may start child runtime sessions with `vf run --input-format stream-json --output-format stream-json` and a `session.start` protocol envelope as needed; use `session.status`, `session.events`, and `wait` to track progress.\nAgent runtime guide:\n- Use unified CLI protocol mode, `vf run --input-format stream-json --output-format stream-json`, to start a child runtime session when the work should run in a separate entity or continue independently from the current turn.\n- Send typed runtime protocol envelopes such as `session.start`, `session.message`, `session.status`, `session.events`, `session.submit`, and `session.stop`; do not treat dedicated `vf agent ...` subcommands as the standard integration surface.\n- Ordinary new sessions stay session-scoped. A room is created or discovered only when a unified CLI runtime protocol start command launches a child runtime session from a server-managed host session and the server projects runtime store metadata/events.\n- Do not use MCP task tools, `vf agent ...`, legacy StartTasks, hand-written DB edits, or ad-hoc TS scripts as the task consumer surface. Use CLI protocol mode and the runtime protocol/store for start, status, events, follow-up messages, input submission, and cancellation.\n- Server-managed host sessions inject the current adapter, model, effort, and permission mode as runtime protocol defaults. Omit these fields to inherit the host selection, or set them explicitly only when a child task must use a different runtime profile.\n- Copyable JSONL example; write one `session.start` line per child task, and use multiple lines for multiple subtasks:\n```bash\ncat <<'JSONL' | vf run --input-format stream-json --output-format stream-json\n{\"commandId\":\"start-planner\",\"type\":\"session.start\",\"payload\":{\"title\":\"Plan Agent Room UI fix\",\"message\":\"Plan the frontend changes and tests for the Agent Room UI fix.\",\"entity\":\"dev-planner\",\"background\":true},\"title\":\"Plan Agent Room UI fix\",\"message\":\"Plan the frontend changes and tests for the Agent Room UI fix.\",\"entity\":\"dev-planner\",\"background\":true}\n{\"commandId\":\"start-reviewer\",\"type\":\"session.start\",\"payload\":{\"title\":\"Review Agent Room UI fix\",\"message\":\"Review the implemented Agent Room UI fix for regressions and missing tests.\",\"entity\":\"dev-reviewer\",\"background\":true},\"title\":\"Review Agent Room UI fix\",\"message\":\"Review the implemented Agent Room UI fix for regressions and missing tests.\",\"entity\":\"dev-reviewer\",\"background\":true}\nJSONL\n```\n- Keep `payload.title`, `payload.message`, `payload.entity`, and `payload.background: true` explicit in each start envelope. The mirrored top-level fields make the JSONL executable by the current `vf run` protocol reader.\n- Include a short `title` when the task prompt is long; it becomes the child session title and room run label. Put any room or workspace context in the title and initial message.\n- Read the returned `sessionId` and use it for follow-up protocol commands. Read the latest runtime snapshot from the runtime store or a `session.status` protocol command, and read progress from runtime events or a `session.events` protocol command.\n- Use a follow/read-events workflow when you need to watch progress instead of repeatedly restarting work.\n- Use a `session.message` protocol command to give an existing session another instruction. Running sessions continue immediately; completed or failed sessions resume the same conversation when the runtime allows resume.\n- When the chat UI sends a `[ROOM_TASK_MESSAGE] ... [/ROOM_TASK_MESSAGE]` block, treat it as a runtime relay envelope instead of ordinary prose. Parse the `sessionId` or legacy `taskId`, `message`, and optional `mode` / `request` fields. If the envelope indicates `mode: interaction`, or runtime status shows `waiting_input` / pending input, use a `session.submit` protocol command. Otherwise use `session.message`. Do not reply inline instead of routing the relay.\n- Use `session.submit` only when a runtime session is waiting for an explicit input or approval request. Do not use it for ordinary follow-up instructions.\n- Use a `session.stop` protocol command for graceful cancellation and set `mode` to `force` only when stop cannot recover the session.\n- Compatibility aliases such as `vf agent start/status/events/send/submit/stop` may exist for debugging or legacy scripts, but they are not the primary guidance for new agent workflows.\n- When a session is still making progress, use `wait` between checks and inspect status/events instead of starting a replacement session.\n</system-prompt>\n\n\n<system-prompt>\nYou are a professional project execution manager who can skillfully direct other entities to work toward your goal. Expectations:\n\n- Never complete code development work alone\n- You must coordinate other developers to complete tasks\n- You must keep them aligned with the goal and verify that their completion reports meet the requirements\n\nChoose the appropriate workflow based on the user's needs and the actual development goal, and use the workflow identifier to locate and load the corresponding definition.\n- Pass the identifier based on the actual need. This is not a path; use the standard workflow loading capability to resolve it.\n- Decide how to pass parameters based on their descriptions and actual usage scenarios.\nThe project includes the following workflows:\n- Workflow name: release\n  - Description: 正式发布流程\n  - Identifier: release\n  - Parameters:\n    - None\n\n- Workflow name: demo/release\n  - Description: 插件发布流程\n  - Identifier: demo/release\n  - Parameters:\n    - None\n\n</system-prompt>\n\n\n执行正式发布，并整理变更摘要。",
       "tools": {
         "include": [
           "Edit",

package/__tests__/adapter-asset-plan.spec.ts

@@ -280,64 +280,6 @@ describe('buildAdapterAssetPlan', () => {
     ]))
   })
 
-  it('keeps explicit skills CLI dependencies ahead of preselected home-bridged skills in overlays', async () => {
-    const workspace = await createWorkspace()
-    const realHome = process.env.__VF_PROJECT_REAL_HOME__
-    const tempInstallDir = join(workspace, '.tmp-install-skills-cli-foo')
-    const installedSkillDir = join(tempInstallDir, '.agents', 'skills', 'foo')
-    await writeDocument(
-      join(installedSkillDir, 'SKILL.md'),
-      '---\nname: foo\ndescription: Registry foo\n---\nUse the registry definition.\n'
-    )
-    skillsCliMocks.installSkillsCliSkillToTemp.mockResolvedValue({
-      tempDir: tempInstallDir,
-      installedSkill: {
-        dirName: 'foo',
-        name: 'foo',
-        sourcePath: installedSkillDir
-      }
-    })
-
-    await writeDocument(
-      join(realHome!, '.agents/skills/foo/SKILL.md'),
-      '---\ndescription: Home foo\n---\nUse the home definition.\n'
-    )
-    await writeDocument(
-      join(workspace, '.ai/skills/app-builder/SKILL.md'),
-      [
-        '---',
-        'name: app-builder',
-        'description: Build apps',
-        'dependencies:',
-        '  - anthropics/skills@foo',
-        '---',
-        'Build the app.'
-      ].join('\n')
-    )
-
-    const bundle = await resolveWorkspaceAssetBundle({
-      cwd: workspace,
-      configs: [undefined, undefined],
-      useDefaultVibeForgeMcpServer: false
-    })
-    const plan = await buildAdapterAssetPlan({
-      adapter: 'opencode',
-      bundle,
-      options: {
-        skills: {
-          include: ['foo', 'app-builder']
-        }
-      }
-    })
-
-    const fooOverlays = plan.overlays.filter(entry => entry.kind === 'skill' && entry.targetPath === 'skills/foo')
-    expect(fooOverlays).toHaveLength(1)
-    expect(fooOverlays[0]?.sourcePath).toContain(
-      '/.ai/caches/skill-dependencies/skills-cli/skills/latest/default/anthropics/skills/latest/foo'
-    )
-    expect(fooOverlays[0]?.sourcePath).not.toBe(join(realHome!, '.agents/skills/foo'))
-  })
-
   it('prunes excluded skill dependency subtrees from selected native overlays', async () => {
     const workspace = await createWorkspace()
 
@@ -394,7 +336,7 @@ describe('buildAdapterAssetPlan', () => {
     ])
   })
 
-  it('builds copilot native skill overlays and translated runtime diagnostics', async () => {
+  it('builds copilot native skill overlays and native hook diagnostics', async () => {
     const workspace = await createWorkspace()
 
     await installPluginPackage(workspace, '@vibe-forge/plugin-logger', {
@@ -489,7 +431,7 @@ describe('buildAdapterAssetPlan', () => {
       expect.objectContaining({
         assetId: loggerHookPluginId,
         adapter: 'copilot',
-        status: 'translated'
+        status: 'native'
       }),
       expect.objectContaining({
         assetId: docsMcpId,

package/__tests__/bundle.spec.ts

@@ -386,79 +386,6 @@ describe('resolveWorkspaceAssetBundle', () => {
     }))
   })
 
-  it('installs selected missing skill dependencies from the skills CLI cache', async () => {
-    const workspace = await createWorkspace()
-    const realHome = process.env.__VF_PROJECT_REAL_HOME__
-    const tempInstallDir = join(workspace, '.tmp-install-skills-cli')
-    const installedSkillDir = join(tempInstallDir, '.agents', 'skills', 'frontend-design')
-    await writeDocument(
-      join(installedSkillDir, 'SKILL.md'),
-      '---\nname: frontend-design\ndescription: UI design guidance\n---\nUse strong visual hierarchy.\n'
-    )
-    skillsCliMocks.installSkillsCliSkillToTemp.mockResolvedValue({
-      tempDir: tempInstallDir,
-      installedSkill: {
-        dirName: 'frontend-design',
-        name: 'frontend-design',
-        sourcePath: installedSkillDir
-      }
-    })
-
-    await writeDocument(
-      join(realHome!, '.agents/skills/frontend-design/SKILL.md'),
-      '---\ndescription: home frontend design\n---\nUse the home definition.'
-    )
-    await writeDocument(
-      join(workspace, '.ai/skills/app-builder/SKILL.md'),
-      [
-        '---',
-        'name: app-builder',
-        'description: Build apps',
-        'dependencies:',
-        '  - anthropics/skills@frontend-design',
-        '---',
-        'Build the app.'
-      ].join('\n')
-    )
-
-    const bundle = await resolveWorkspaceAssetBundle({
-      cwd: workspace,
-      configs: [undefined, undefined],
-      useDefaultVibeForgeMcpServer: false
-    })
-
-    expect(bundle.skills.map(asset => asset.name).sort()).toEqual(['app-builder', 'frontend-design'])
-    expect(bundle.skills.find(asset => asset.name === 'frontend-design')).toEqual(expect.objectContaining({
-      resolvedBy: 'home-bridge',
-      sourcePath: join(realHome!, '.agents/skills/frontend-design/SKILL.md')
-    }))
-
-    await buildAdapterAssetPlan({
-      adapter: 'opencode',
-      bundle,
-      options: {
-        skills: {
-          include: ['app-builder']
-        }
-      }
-    })
-
-    const dependency = bundle.skills.find(asset => asset.name === 'frontend-design')
-    expect(bundle.skills.map(asset => asset.name).sort()).toEqual(['app-builder', 'frontend-design'])
-    expect(dependency?.sourcePath).toContain(
-      '/.ai/caches/skill-dependencies/skills-cli/skills/latest/default/anthropics/skills/latest/frontend-design/'
-    )
-    expect(bundle.skills.find(asset => (
-      asset.name === 'frontend-design' && asset.resolvedBy === 'home-bridge'
-    ))).toBeUndefined()
-    expect(skillsCliMocks.findSkillsCli).not.toHaveBeenCalled()
-    expect(skillsCliMocks.installSkillsCliSkillToTemp).toHaveBeenCalledWith({
-      config: undefined,
-      skill: 'frontend-design',
-      source: 'anthropics/skills'
-    })
-  })
-
   it('installs configured project skills before bundle resolution and rewrites renamed skill names', async () => {
     const workspace = await createWorkspace()
     const tempInstallDir = join(workspace, '.tmp-configured-install')
@@ -564,171 +491,6 @@ describe('resolveWorkspaceAssetBundle', () => {
     )
   })
 
-  it('installs skill dependencies into the primary workspace shared cache', async () => {
-    const primary = await createWorkspace()
-    const worktree = await createWorkspace()
-    const previousPrimaryWorkspace = process.env.__VF_PROJECT_PRIMARY_WORKSPACE_FOLDER__
-    const tempInstallDir = join(worktree, '.tmp-install-skills-cli')
-    const installedSkillDir = join(tempInstallDir, '.agents', 'skills', 'frontend-design')
-    await writeDocument(
-      join(installedSkillDir, 'SKILL.md'),
-      '---\nname: frontend-design\ndescription: UI design guidance\n---\nUse primary cache.\n'
-    )
-    skillsCliMocks.installSkillsCliSkillToTemp.mockResolvedValue({
-      tempDir: tempInstallDir,
-      installedSkill: {
-        dirName: 'frontend-design',
-        name: 'frontend-design',
-        sourcePath: installedSkillDir
-      }
-    })
-
-    try {
-      process.env.__VF_PROJECT_PRIMARY_WORKSPACE_FOLDER__ = primary
-      await writeDocument(
-        join(worktree, '.ai/skills/app-builder/SKILL.md'),
-        [
-          '---',
-          'name: app-builder',
-          'description: Build apps',
-          'dependencies:',
-          '  - anthropics/skills@frontend-design',
-          '---',
-          'Build the app.'
-        ].join('\n')
-      )
-
-      const bundle = await resolveWorkspaceAssetBundle({
-        cwd: worktree,
-        configs: [undefined, undefined],
-        useDefaultVibeForgeMcpServer: false
-      })
-
-      await buildAdapterAssetPlan({
-        adapter: 'opencode',
-        bundle,
-        options: {
-          skills: {
-            include: ['app-builder']
-          }
-        }
-      })
-
-      const dependency = bundle.skills.find(asset => asset.name === 'frontend-design')
-      expect(dependency?.sourcePath).toContain(join(
-        primary,
-        '.ai/caches/skill-dependencies/skills-cli/skills/latest/default/anthropics/skills/latest/frontend-design/'
-      ))
-      expect(dependency?.sourcePath).not.toContain(join(worktree, '.ai/caches'))
-    } finally {
-      if (previousPrimaryWorkspace == null) {
-        delete process.env.__VF_PROJECT_PRIMARY_WORKSPACE_FOLDER__
-      } else {
-        process.env.__VF_PROJECT_PRIMARY_WORKSPACE_FOLDER__ = previousPrimaryWorkspace
-      }
-    }
-  })
-
-  it('reuses complete skill dependency caches without deleting or downloading them again', async () => {
-    const workspace = await createWorkspace()
-
-    const cachedSkillPath = join(
-      workspace,
-      '.ai/caches/skill-dependencies/skills-cli/skills/latest/default/anthropics/skills/latest/frontend-design/SKILL.md'
-    )
-    await writeDocument(
-      cachedSkillPath,
-      '---\nname: frontend-design\ndescription: Cached UI guidance\n---\nUse the cached copy.\n'
-    )
-    await writeDocument(
-      join(workspace, '.ai/skills/app-builder/SKILL.md'),
-      [
-        '---',
-        'name: app-builder',
-        'description: Build apps',
-        'dependencies:',
-        '  - anthropics/skills@frontend-design',
-        '---',
-        'Build the app.'
-      ].join('\n')
-    )
-
-    const bundle = await resolveWorkspaceAssetBundle({
-      cwd: workspace,
-      configs: [undefined, undefined],
-      useDefaultVibeForgeMcpServer: false
-    })
-
-    await buildAdapterAssetPlan({
-      adapter: 'opencode',
-      bundle,
-      options: {
-        skills: {
-          include: ['app-builder']
-        }
-      }
-    })
-
-    expect(skillsCliMocks.findSkillsCli).not.toHaveBeenCalled()
-    expect(skillsCliMocks.installSkillsCliSkillToTemp).not.toHaveBeenCalled()
-    expect(await readFile(cachedSkillPath, 'utf8')).toContain('Use the cached copy.')
-    expect(bundle.skills.map(asset => asset.name).sort()).toEqual(['app-builder', 'frontend-design'])
-  })
-
-  it('parses registry/source/version dependency specs and forwards them to the skills CLI installer', async () => {
-    const workspace = await createWorkspace()
-    const tempInstallDir = join(workspace, '.tmp-install-skills-cli')
-    const installedSkillDir = join(tempInstallDir, '.agents', 'skills', 'frontend-design')
-    await writeDocument(
-      join(installedSkillDir, 'SKILL.md'),
-      '---\nname: frontend-design\ndescription: UI design guidance\n---\nUse internal design tokens.\n'
-    )
-    skillsCliMocks.installSkillsCliSkillToTemp.mockResolvedValue({
-      tempDir: tempInstallDir,
-      installedSkill: {
-        dirName: 'frontend-design',
-        name: 'frontend-design',
-        sourcePath: installedSkillDir
-      }
-    })
-
-    await writeDocument(
-      join(workspace, '.ai/skills/app-builder/SKILL.md'),
-      [
-        '---',
-        'name: app-builder',
-        'description: Build apps',
-        'dependencies:',
-        '  - https://registry.example.com@example-source/default/public@frontend-design@1.0.3',
-        '---',
-        'Build the app.'
-      ].join('\n')
-    )
-
-    const bundle = await resolveWorkspaceAssetBundle({
-      cwd: workspace,
-      configs: [undefined, undefined],
-      useDefaultVibeForgeMcpServer: false
-    })
-
-    await buildAdapterAssetPlan({
-      adapter: 'opencode',
-      bundle,
-      options: {
-        skills: {
-          include: ['app-builder']
-        }
-      }
-    })
-
-    expect(skillsCliMocks.installSkillsCliSkillToTemp).toHaveBeenCalledWith({
-      registry: 'https://registry.example.com',
-      skill: 'frontend-design',
-      source: 'example-source/default/public',
-      version: '1.0.3'
-    })
-  })
-
   it('loads workspace entities from the env-configured entities dir', async () => {
     const workspace = await createWorkspace()
     const previousEntitiesDir = process.env.__VF_PROJECT_AI_ENTITIES_DIR__

package/__tests__/prompt-builders.spec.ts

@@ -174,20 +174,35 @@ describe('workspace asset prompt builders', () => {
     ])
 
     expect(prompt).toContain('reviewer: 负责代码审查')
-    expect(prompt).toContain('`VibeForge.StartTasks`')
-    expect(prompt).toContain('`VibeForge.GetTaskInfo`')
-    expect(prompt).toContain('Task tool guide:')
-    expect(prompt).toContain('After starting a task')
-    expect(prompt).toContain('10 most recent log entries')
-    expect(prompt).toContain('`logLimit`')
-    expect(prompt).toContain('`logOrder`')
-    expect(prompt).toContain('`VibeForge.SendTaskMessage`')
-    expect(prompt).toContain('`{ taskId, message }`')
-    expect(prompt).toContain('`VibeForge.SubmitTaskInput`')
+    expect(prompt).toContain('Agent runtime guide:')
+    expect(prompt).toContain('`vf run --input-format stream-json --output-format stream-json`')
+    expect(prompt).toContain("cat <<'JSONL' | vf run --input-format stream-json --output-format stream-json")
+    expect(prompt).toContain('"commandId":"start-planner"')
+    expect(prompt).toContain('"type":"session.start"')
+    expect(prompt).toContain('"payload":{"title":"Plan Agent Room UI fix"')
+    expect(prompt).toContain('"entity":"dev-planner"')
+    expect(prompt).toContain('"background":true')
+    expect(prompt).toContain('write one `session.start` line per child task')
+    expect(prompt).toContain('typed runtime protocol envelopes')
+    expect(prompt).toContain('do not treat dedicated `vf agent ...` subcommands as the standard integration surface')
+    expect(prompt).toContain('Read the returned `sessionId`')
+    expect(prompt).toContain('Ordinary new sessions stay session-scoped')
+    expect(prompt).toContain('Do not use MCP task tools, `vf agent ...`, legacy StartTasks')
+    expect(prompt).toContain('hand-written DB edits')
+    expect(prompt).toContain('ad-hoc TS scripts')
+    expect(prompt).toContain('server-managed host session')
+    expect(prompt).toContain('server projects runtime store metadata/events')
+    expect(prompt).toContain('`session.status` protocol command')
+    expect(prompt).toContain('`session.events` protocol command')
+    expect(prompt).toContain('`session.message` protocol command')
+    expect(prompt).toContain('[ROOM_TASK_MESSAGE]')
+    expect(prompt).toContain('`mode: interaction`')
+    expect(prompt).toContain('`waiting_input`')
+    expect(prompt).toContain('`session.submit` protocol command')
     expect(prompt).toContain('Do not use it for ordinary follow-up instructions')
-    expect(prompt).toContain('completed or failed tasks resume the same conversation')
-    expect(prompt).toContain('keep working in that same thread of execution')
+    expect(prompt).toContain('completed or failed sessions resume the same conversation')
     expect(prompt).toContain('`wait`')
+    expect(prompt).not.toContain('VibeForge.StartTasks')
     expect(prompt).not.toContain('run-tasks')
     expect(prompt).not.toContain('需要关注变更风险')
     expect(prompt).not.toContain('hidden')
@@ -207,14 +222,19 @@ describe('workspace asset prompt builders', () => {
 
     expect(prompt).toContain('The project includes the following registered workspaces')
     expect(prompt).toContain('Identifier: billing')
-    expect(prompt).toContain('`VibeForge.StartTasks`')
-    expect(prompt).toContain('type: "workspace"')
-    expect(prompt).toContain('Task tool guide:')
-    expect(prompt).toContain('`VibeForge.GetTaskInfo`')
-    expect(prompt).toContain('`VibeForge.ListTasks`')
-    expect(prompt).toContain('`VibeForge.SendTaskMessage`')
-    expect(prompt).toContain('`VibeForge.SubmitTaskInput`')
+    expect(prompt).toContain('workspace identifier and path')
+    expect(prompt).toContain('Agent runtime guide:')
+    expect(prompt).toContain('`vf run --input-format stream-json --output-format stream-json`')
+    expect(prompt).toContain('"payload":{"title":"Plan Agent Room UI fix"')
+    expect(prompt).toContain('"payload":{"title":"Review Agent Room UI fix"')
+    expect(prompt).toContain('payload.background: true')
+    expect(prompt).toContain('multiple subtasks')
+    expect(prompt).toContain('`session.status` protocol command')
+    expect(prompt).toContain('`session.events` protocol command')
+    expect(prompt).toContain('`session.message` protocol command')
+    expect(prompt).toContain('`session.submit`')
     expect(prompt).toContain('Do not directly edit files inside a registered workspace')
+    expect(prompt).not.toContain('VibeForge.StartTasks')
   })
 
   it('builds skill route prompts without preloading content', () => {

package/__tests__/skill-dependencies-cli.spec.ts

@@ -1,9 +1,7 @@
 /* eslint-disable import/first -- hoisted vitest mocks must be declared before importing the bundle entrypoint */
-import { access, mkdir, mkdtemp, rm, utimes, writeFile } from 'node:fs/promises'
-import os from 'node:os'
-import path, { join } from 'node:path'
+import { join } from 'node:path'
 
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { beforeEach, describe, expect, it, vi } from 'vitest'
 
 const mocks = vi.hoisted(() => ({
   findSkillsCli: vi.fn(),
@@ -23,54 +21,15 @@ vi.mock('@vibe-forge/utils/skills-cli', async () => {
 
 import { buildAdapterAssetPlan, resolveWorkspaceAssetBundle } from '#~/index.js'
 
-import { createWorkspace, writeDocument } from './test-helpers'
+import { createWorkspace, installPluginPackage, writeDocument } from './test-helpers'
 
-describe('skills CLI dependency resolution', () => {
-  let installWorkspace: string
-
-  const pathExists = async (targetPath: string) => {
-    try {
-      await access(targetPath)
-      return true
-    } catch {
-      return false
-    }
-  }
-
-  beforeEach(async () => {
-    installWorkspace = await mkdtemp(path.join(os.tmpdir(), 'vf-skills-cli-dependency-'))
+describe('materialized skill dependency resolution', () => {
+  beforeEach(() => {
     vi.clearAllMocks()
   })
 
-  afterEach(async () => {
-    await rm(installWorkspace, { recursive: true, force: true })
-  })
-
-  it('installs missing bare-name dependencies through skills CLI by default', async () => {
+  it('fails missing dependencies without downloading during runtime preparation', async () => {
     const workspace = await createWorkspace()
-    const installedSkillDir = join(installWorkspace, '.agents', 'skills', 'frontend-design')
-    await mkdir(installedSkillDir, { recursive: true })
-    await writeFile(
-      join(installedSkillDir, 'SKILL.md'),
-      '---\nname: frontend-design\ndescription: UI design guidance\n---\nUse strong visual hierarchy.\n'
-    )
-
-    mocks.findSkillsCli.mockResolvedValue([
-      {
-        installRef: 'anthropics/skills@frontend-design',
-        source: 'anthropics/skills',
-        skill: 'frontend-design'
-      }
-    ])
-    mocks.installSkillsCliRefToTemp.mockResolvedValue({
-      tempDir: installWorkspace,
-      installedSkill: {
-        dirName: 'frontend-design',
-        name: 'frontend-design',
-        sourcePath: installedSkillDir
-      }
-    })
-
     await writeDocument(
       join(workspace, '.ai/skills/app-builder/SKILL.md'),
       [
@@ -90,7 +49,7 @@ describe('skills CLI dependency resolution', () => {
       useDefaultVibeForgeMcpServer: false
     })
 
-    await buildAdapterAssetPlan({
+    await expect(buildAdapterAssetPlan({
       adapter: 'opencode',
       bundle,
       options: {
@@ -98,39 +57,15 @@ describe('skills CLI dependency resolution', () => {
           include: ['app-builder']
         }
       }
-    })
+    })).rejects.toThrow('Run vf skills install or vf skills update')
 
-    const dependency = bundle.skills.find(asset => asset.name === 'frontend-design')
-    expect(bundle.skills.map(asset => asset.name).sort()).toEqual(['app-builder', 'frontend-design'])
-    expect(dependency?.sourcePath).toContain(
-      '/.ai/caches/skill-dependencies/skills-cli/skills/latest/default/anthropics/skills/latest/frontend-design/'
-    )
-    expect(mocks.findSkillsCli).toHaveBeenCalledWith({
-      query: 'frontend-design'
-    })
-    expect(mocks.installSkillsCliRefToTemp).toHaveBeenCalledWith({
-      installRef: 'anthropics/skills@frontend-design'
-    })
+    expect(mocks.findSkillsCli).not.toHaveBeenCalled()
+    expect(mocks.installSkillsCliRefToTemp).not.toHaveBeenCalled()
+    expect(mocks.installSkillsCliSkillToTemp).not.toHaveBeenCalled()
   })
 
-  it('parses registry and version from dependency specs', async () => {
+  it('uses project-materialized dependencies from .ai/skills', async () => {
     const workspace = await createWorkspace()
-    const installedSkillDir = join(installWorkspace, '.agents', 'skills', 'frontend-design')
-    await mkdir(installedSkillDir, { recursive: true })
-    await writeFile(
-      join(installedSkillDir, 'SKILL.md'),
-      '---\nname: frontend-design\ndescription: UI design guidance\n---\nUse internal design system.\n'
-    )
-
-    mocks.installSkillsCliSkillToTemp.mockResolvedValue({
-      tempDir: installWorkspace,
-      installedSkill: {
-        dirName: 'frontend-design',
-        name: 'frontend-design',
-        sourcePath: installedSkillDir
-      }
-    })
-
     await writeDocument(
       join(workspace, '.ai/skills/app-builder/SKILL.md'),
       [
@@ -138,19 +73,22 @@ describe('skills CLI dependency resolution', () => {
         'name: app-builder',
         'description: Build apps',
         'dependencies:',
-        '  - https://registry.example.com@example-source/default/public@frontend-design@1.0.3',
+        '  - frontend-design',
         '---',
         'Build the app.'
       ].join('\n')
     )
+    await writeDocument(
+      join(workspace, '.ai/skills/frontend-design/SKILL.md'),
+      '---\nname: frontend-design\ndescription: UI design guidance\n---\nUse strong visual hierarchy.\n'
+    )
 
     const bundle = await resolveWorkspaceAssetBundle({
       cwd: workspace,
       configs: [undefined, undefined],
       useDefaultVibeForgeMcpServer: false
     })
-
-    await buildAdapterAssetPlan({
+    const plan = await buildAdapterAssetPlan({
       adapter: 'opencode',
       bundle,
       options: {
@@ -160,75 +98,79 @@ describe('skills CLI dependency resolution', () => {
       }
     })
 
-    expect(mocks.installSkillsCliSkillToTemp).toHaveBeenCalledWith({
-      registry: 'https://registry.example.com',
-      skill: 'frontend-design',
-      source: 'example-source/default/public',
-      version: '1.0.3'
-    })
+    expect(plan.overlays.filter(entry => entry.kind === 'skill').map(entry => entry.targetPath).sort()).toEqual([
+      'skills/app-builder',
+      'skills/frontend-design'
+    ])
+    expect(mocks.findSkillsCli).not.toHaveBeenCalled()
   })
 
-  it('clears stale dependency install locks before retrying a direct startup install', async () => {
+  it('loads plugin dependencies from .ai/skills/.plugins through the lockfile', async () => {
     const workspace = await createWorkspace()
-    const installedSkillDir = join(installWorkspace, '.agents', 'skills', 'lynx-cat')
-    await mkdir(installedSkillDir, { recursive: true })
-    await writeFile(
-      join(installedSkillDir, 'SKILL.md'),
-      '---\nname: lynx-cat\ndescription: Lynx helper\n---\nDebug Lynx apps.\n'
-    )
-
-    mocks.installSkillsCliSkillToTemp.mockResolvedValue({
-      tempDir: installWorkspace,
-      installedSkill: {
-        dirName: 'lynx-cat',
-        name: 'lynx-cat',
-        sourcePath: installedSkillDir
-      }
-    })
-
-    await writeDocument(
-      join(workspace, '.ai/skills/lynx-miniapp/SKILL.md'),
-      [
+    await installPluginPackage(workspace, '@vibe-forge/plugin-review', {
+      'package.json': JSON.stringify({ name: '@vibe-forge/plugin-review', version: '1.0.0' }, null, 2),
+      'skills/review-helper/SKILL.md': [
         '---',
-        'name: lynx-miniapp',
-        'description: lynx 调试使用',
+        'name: review-helper',
+        'description: Review helper',
         'dependencies:',
-        '  - https://registry.example.com@example-source/lynx/skills@lynx-cat@latest',
+        '  - shared-runtime',
         '---',
-        '这是一个测试的 lynx 调试技能'
+        'Review code.'
       ].join('\n')
+    })
+    await writeDocument(
+      join(workspace, '.ai/skills/.plugins/review/shared-runtime/SKILL.md'),
+      '---\nname: shared-runtime\ndescription: Shared runtime\n---\nShared plugin dependency.\n'
     )
-
-    const lockDir = join(
-      workspace,
-      '.ai/caches/skill-dependencies/skills-cli/skills/latest/https-registry.example.com/example-source/lynx/skills/latest/lynx-cat.lock'
+    await writeDocument(
+      join(workspace, '.ai/skills.lock.yaml'),
+      [
+        'version: 1',
+        'pluginSkills:',
+        '  review/shared-runtime:',
+        '    name: shared-runtime',
+        '    requested: false',
+        '    pluginInstance: review',
+        '    pluginInstancePath: "0"',
+        '    installPath: .ai/skills/.plugins/review/shared-runtime',
+        '    dependencyOf:',
+        '      - plugin:review/review-helper',
+        '    source: vendor/shared-skills',
+        '    version: 1.0.0',
+        '    hash: sha256:test',
+        '    installedAt: "2026-05-13T00:00:00.000Z"'
+      ].join('\n')
     )
-    await mkdir(lockDir, { recursive: true })
-    await utimes(lockDir, new Date(Date.now() - 120_000), new Date(Date.now() - 120_000))
 
     const bundle = await resolveWorkspaceAssetBundle({
       cwd: workspace,
-      configs: [undefined, undefined],
+      configs: [{
+        plugins: [{
+          id: '@vibe-forge/plugin-review',
+          scope: 'review'
+        }]
+      }, undefined],
       useDefaultVibeForgeMcpServer: false
     })
-
-    await buildAdapterAssetPlan({
+    const plan = await buildAdapterAssetPlan({
       adapter: 'opencode',
       bundle,
       options: {
         skills: {
-          include: ['lynx-miniapp']
+          include: ['review/review-helper']
         }
       }
     })
 
-    expect(mocks.installSkillsCliSkillToTemp).toHaveBeenCalledWith({
-      registry: 'https://registry.example.com',
-      skill: 'lynx-cat',
-      source: 'example-source/lynx/skills',
-      version: 'latest'
-    })
-    await expect(pathExists(lockDir)).resolves.toBe(false)
-    expect(bundle.skills.map(asset => asset.name).sort()).toEqual(['lynx-cat', 'lynx-miniapp'])
+    expect(bundle.skills.map(asset => asset.displayName).sort()).toEqual([
+      'review/review-helper',
+      'review/shared-runtime'
+    ])
+    expect(plan.overlays.filter(entry => entry.kind === 'skill').map(entry => entry.targetPath).sort()).toEqual([
+      'skills/review__review-helper',
+      'skills/review__shared-runtime'
+    ])
+    expect(mocks.installSkillsCliSkillToTemp).not.toHaveBeenCalled()
   })
 })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-forge/workspace-assets",
-  "version": "3.0.0",
+  "version": "3.1.1-alpha.0",
   "description": "Workspace asset resolution and adapter asset planning for Vibe Forge",
   "imports": {
     "#~/*.js": {
@@ -29,10 +29,10 @@
     "fast-glob": "^3.3.3",
     "front-matter": "^4.0.2",
     "js-yaml": "^4.1.1",
-    "@vibe-forge/types": "3.0.0",
-    "@vibe-forge/definition-core": "3.0.0",
-    "@vibe-forge/utils": "3.0.0",
-    "@vibe-forge/config": "3.0.0"
+    "@vibe-forge/config": "3.1.5",
+    "@vibe-forge/definition-core": "3.1.0",
+    "@vibe-forge/types": "3.1.6-alpha.0",
+    "@vibe-forge/utils": "3.1.6-alpha.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9"

package/src/adapter-asset-plan.ts

@@ -78,7 +78,7 @@ export async function buildAdapterAssetPlan(params: {
   params.bundle.hookPlugins.forEach((asset) => {
     pushDiagnostic(asset, {
       adapter: params.adapter,
-      status: params.adapter === 'copilot' ? 'translated' : 'native',
+      status: 'native',
       reason: params.adapter === 'claude-code'
         ? 'Mapped into the Claude Code native hooks bridge.'
         : params.adapter === 'codex'
@@ -86,7 +86,7 @@ export async function buildAdapterAssetPlan(params: {
         : params.adapter === 'gemini'
         ? 'Mapped into the Gemini native hooks bridge.'
         : params.adapter === 'copilot'
-        ? 'Handled by the Vibe Forge task hook bridge.'
+        ? 'Mapped into the Copilot CLI native hooks bridge.'
         : params.adapter === 'kimi'
         ? 'Mapped into the Kimi native hooks bridge.'
         : 'Mapped into the OpenCode native hooks bridge.'

package/src/bundle-internal.ts

@@ -1,4 +1,4 @@
-import { readFile } from 'node:fs/promises'
+import { access, readFile } from 'node:fs/promises'
 import { basename, dirname, extname, isAbsolute, resolve } from 'node:path'
 import process from 'node:process'
 
@@ -11,6 +11,7 @@ import {
 import type { Config, Definition, Entity, PluginConfig, WorkspaceAsset, WorkspaceAssetKind } from '@vibe-forge/types'
 import {
   isLegacySkillsConfig,
+  readProjectSkillsLockfile,
   resolveProjectAiBaseDir,
   resolveProjectAiEntitiesDir,
   resolveRelativePath
@@ -35,6 +36,7 @@ import {
 } from '@vibe-forge/definition-core'
 import { ensureConfiguredProjectSkills } from './configured-skills'
 import { HOME_BRIDGE_RESOLVED_BY } from './home-bridge'
+import { PLUGIN_SKILL_DEPENDENCY_RESOLVED_BY } from './plugin-skill-dependencies'
 import { resolveConfiguredWorkspaceAssets } from './workspaces'
 
 type DocumentAssetKind = Extract<WorkspaceAssetKind, 'rule' | 'spec' | 'entity' | 'skill'>
@@ -440,6 +442,40 @@ const scanInstanceDocuments = async (instance: ResolvedPluginInstance) => {
   }
 }
 
+const pathExists = async (path: string) => {
+  try {
+    await access(path)
+    return true
+  } catch {
+    return false
+  }
+}
+
+const scanPluginDependencySkillDocuments = async (
+  cwd: string,
+  instances: ResolvedPluginInstance[]
+) => {
+  const lockfile = await readProjectSkillsLockfile(cwd)
+  const documents: Array<{ instance: ResolvedPluginInstance; path: string }> = []
+  for (const entry of Object.values(lockfile.pluginSkills ?? {})) {
+    const instance = instances.find(candidate => (
+      candidate.instancePath === entry.pluginInstancePath ||
+      candidate.scope === entry.pluginInstance
+    ))
+    if (instance == null) continue
+
+    const skillPath = resolve(cwd, entry.installPath, 'SKILL.md')
+    if (await pathExists(skillPath)) {
+      documents.push({
+        instance,
+        path: skillPath
+      })
+    }
+  }
+
+  return documents
+}
+
 const toOpenCodeOverlayEntries = (
   kind: OpenCodeOverlayKind,
   targetDir: 'agents' | 'commands' | 'modes' | 'plugins',
@@ -578,6 +614,7 @@ export async function collectWorkspaceAssets(params: {
   ])
   const flattenedPluginInstances = flattenPluginInstances(pluginInstances)
   const pluginScans = await Promise.all(flattenedPluginInstances.map(instance => scanInstanceDocuments(instance)))
+  const pluginDependencySkillDocs = await scanPluginDependencySkillDocuments(params.cwd, flattenedPluginInstances)
   const pluginOverlayScans = await Promise.all(
     flattenedPluginInstances.map(instance => scanInstanceOpenCodeOverlays(instance))
   )
@@ -631,6 +668,16 @@ export async function collectWorkspaceAssets(params: {
     await pushDocumentAssets('entity', scan.entityDocPaths, 'plugin', instance, parseEntityMarkdownDocument)
     await pushDocumentAssets('entity', scan.entityJsonPaths, 'plugin', instance, parseEntityIndexJson)
   }
+  for (const entry of pluginDependencySkillDocs) {
+    await pushDocumentAssets(
+      'skill',
+      [entry.path],
+      'plugin',
+      entry.instance,
+      undefined,
+      PLUGIN_SKILL_DEPENDENCY_RESOLVED_BY
+    )
+  }
   await pushDocumentAssets('skill', homeSkillPaths, 'workspace', undefined, undefined, HOME_BRIDGE_RESOLVED_BY)
 
   const skills = mergeSkillAssets(skillAssets)

package/src/plugin-skill-dependencies.ts

@@ -0,0 +1 @@
+export const PLUGIN_SKILL_DEPENDENCY_RESOLVED_BY = 'plugin-skill-dependency-lock'

package/src/prompt-builders.ts

@@ -5,7 +5,7 @@ import {
   resolveSpecIdentifier
 } from '@vibe-forge/definition-core'
 import type { Definition, Entity, Rule, Skill, Spec } from '@vibe-forge/types'
-import { CANONICAL_VIBE_FORGE_MCP_SERVER_NAME, resolvePromptPath } from '@vibe-forge/utils'
+import { resolvePromptPath } from '@vibe-forge/utils'
 
 import { buildManagedTaskToolGuidance } from './task-tool-guidance'
 
@@ -167,7 +167,7 @@ export const generateSpecRoutePrompt = (
 }
 
 export const generateEntitiesRoutePrompt = (entities: Definition<Entity>[]) => {
-  const taskToolGuidance = buildManagedTaskToolGuidance(CANONICAL_VIBE_FORGE_MCP_SERVER_NAME)
+  const taskToolGuidance = buildManagedTaskToolGuidance()
   return (
     '<system-prompt>\n' +
     'The project includes the following entities:\n' +
@@ -181,7 +181,7 @@ export const generateEntitiesRoutePrompt = (entities: Definition<Entity>[]) => {
         })
         .join('')
     }\n` +
-    `When solving user problems, you may specify entities through \`${CANONICAL_VIBE_FORGE_MCP_SERVER_NAME}.StartTasks\` as needed and have them coordinate multiple entity types to complete the work; use \`${CANONICAL_VIBE_FORGE_MCP_SERVER_NAME}.GetTaskInfo\` and \`wait\` to track progress.\n` +
+    'When solving user problems, you may start child runtime sessions with `vf run --input-format stream-json --output-format stream-json` and a `session.start` protocol envelope as needed; use `session.status`, `session.events`, and `wait` to track progress.\n' +
     `${taskToolGuidance}\n` +
     '</system-prompt>\n'
   )

package/src/selection-internal.ts

@@ -26,6 +26,7 @@ import {
   isRemoteRuleReference,
   parseScopedReference
 } from '@vibe-forge/definition-core'
+import { PLUGIN_SKILL_DEPENDENCY_RESOLVED_BY } from './plugin-skill-dependencies'
 import { expandSkillAssetDependencies, expandSkillAssetDependenciesWithRemoteResolution } from './skill-dependencies'
 
 type DocumentAssetKind = Extract<WorkspaceAssetKind, 'rule' | 'spec' | 'entity' | 'skill'>
@@ -359,6 +360,10 @@ const mergeEntityDefinitions = (
 
 const uniqueAssetIds = (values: string[]) => toUniqueValues(values, value => value)
 
+const isPluginSkillDependencyAsset = (asset: Extract<WorkspaceAsset, { kind: 'skill' }>) => (
+  asset.resolvedBy === PLUGIN_SKILL_DEPENDENCY_RESOLVED_BY
+)
+
 const formatEntityCycle = (stack: EntityAsset[], asset: EntityAsset) => (
   [...stack.slice(stack.findIndex(item => item.id === asset.id)), asset]
     .map(item => item.displayName)
@@ -517,9 +522,10 @@ export const resolveSelectedSkillAssets = (
 ): Array<Extract<WorkspaceAsset, { kind: 'skill' }>> => {
   if (selection == null) return assets
 
+  const rootAssets = assets.filter(asset => !isPluginSkillDependencyAsset(asset))
   const included = selection.include != null && selection.include.length > 0
     ? resolveNamedAssets(assets, selection.include)
-    : assets
+    : rootAssets
   const excluded = new Set(
     resolveNamedAssets(assets, selection.exclude).map(asset => asset.id)
   )
@@ -532,9 +538,10 @@ export const resolveSelectedSkillAssetsWithDependencies = async (
   bundle: WorkspaceAssetBundle,
   selection?: WorkspaceSkillSelection
 ): Promise<Array<Extract<WorkspaceAsset, { kind: 'skill' }>>> => {
+  const rootAssets = bundle.skills.filter(asset => !isPluginSkillDependencyAsset(asset))
   const included = selection?.include != null && selection.include.length > 0
     ? resolveNamedAssets(bundle.skills, selection.include)
-    : bundle.skills
+    : rootAssets
   const excluded = new Set(
     resolveNamedAssets(bundle.skills, selection?.exclude).map(asset => asset.id)
   )

package/src/skill-dependencies.ts

@@ -1,14 +1,9 @@
 /* eslint-disable max-lines -- dependency normalization and graph expansion share the same local helpers */
-import { readFile } from 'node:fs/promises'
-
-import fm from 'front-matter'
-
-import { parseScopedReference, resolveSkillIdentifier } from '@vibe-forge/definition-core'
-import type { Config, Definition, Skill, WorkspaceAsset } from '@vibe-forge/types'
-import { formatSkillsSpec, parseSkillsSpec, resolveRelativePath } from '@vibe-forge/utils'
+import { parseScopedReference } from '@vibe-forge/definition-core'
+import type { Config, Skill, WorkspaceAsset } from '@vibe-forge/types'
+import { formatSkillsSpec, parseSkillsSpec } from '@vibe-forge/utils'
 
 import { HOME_BRIDGE_RESOLVED_BY } from './home-bridge'
-import { installSkillsCliDependency } from './skills-cli-dependency'
 
 type SkillAsset = Extract<WorkspaceAsset, { kind: 'skill' }>
 
@@ -106,39 +101,6 @@ const findSkillAssetByRef = (
   return resolveUniqueSkillByName(searchableAssets, ref)
 }
 
-const resolveDisplayName = (name: string, scope?: string) => (
-  scope != null && scope.trim() !== '' ? `${scope}/${name}` : name
-)
-
-const parseFrontmatterSkill = async (path: string): Promise<Definition<Skill>> => {
-  const content = await readFile(path, 'utf-8')
-  const { body, attributes } = fm<Skill>(content)
-  return {
-    path,
-    body,
-    attributes
-  }
-}
-
-const createResolvedSkillAsset = (params: {
-  cwd: string
-  definition: Definition<Skill>
-}) => {
-  const name = resolveSkillIdentifier(params.definition.path, params.definition.attributes.name)
-  const displayName = resolveDisplayName(name)
-  return {
-    id: `skill:workspace:workspace:${displayName}:${resolveRelativePath(params.cwd, params.definition.path)}`,
-    kind: 'skill',
-    name,
-    displayName,
-    origin: 'workspace',
-    sourcePath: params.definition.path,
-    payload: {
-      definition: params.definition
-    }
-  } satisfies SkillAsset
-}
-
 export const normalizeSkillDependency = (value: unknown): NormalizedSkillDependency | undefined => {
   const stringValue = asNonEmptyString(value)
   if (stringValue != null) return parseSkillsSpec(stringValue)
@@ -230,8 +192,6 @@ export const expandSkillAssetDependenciesWithRemoteResolution = async (
 ) => {
   const selected: SkillAsset[] = []
   const seen = new Set<string>()
-  const fetchedDependencyRefs = new Set<string>()
-
   const removeSupersededHomeBridgeSkill = (displayName: string) => {
     removeHomeBridgeSkillDuplicates(params.allAssets, displayName)
     removeHomeBridgeSkillDuplicates(params.skillAssets, displayName)
@@ -239,54 +199,6 @@ export const expandSkillAssetDependenciesWithRemoteResolution = async (
     removeHomeBridgeSkillDuplicates(selected, displayName)
   }
 
-  const installDependencyAsset = async (
-    dependency: NormalizedSkillDependency,
-    currentInstancePath?: string
-  ) => {
-    const fetchKey = dependency.ref
-    if (!fetchedDependencyRefs.has(fetchKey)) {
-      fetchedDependencyRefs.add(fetchKey)
-      const installed = await installSkillsCliDependency({
-        cwd: params.cwd,
-        configs: params.configs,
-        dependency
-      })
-      const definition = await parseFrontmatterSkill(installed.skillPath)
-      const dependencyAsset = createResolvedSkillAsset({
-        cwd: params.cwd,
-        definition
-      })
-      const existingAsset = findSkillDependencyAsset(
-        params.skillAssets,
-        dependency,
-        currentInstancePath,
-        { includeHomeBridge: false }
-      ) ??
-        params.skillAssets.find(existing => (
-          existing.resolvedBy !== HOME_BRIDGE_RESOLVED_BY &&
-          existing.displayName === dependencyAsset.displayName
-        ))
-      if (existingAsset != null) {
-        removeSupersededHomeBridgeSkill(existingAsset.displayName)
-        return existingAsset
-      }
-
-      removeSupersededHomeBridgeSkill(dependencyAsset.displayName)
-      params.allAssets.push(dependencyAsset)
-      params.skillAssets.push(dependencyAsset)
-      return dependencyAsset
-    }
-
-    // After the first fetch attempt, reuse whichever asset is now visible in the
-    // skill set: a newly installed registry skill, or a home-bridge fallback
-    // that was accepted by an earlier plain-name dependency resolution.
-    const resolvedAsset = findSkillDependencyAsset(params.skillAssets, dependency, currentInstancePath)
-    if (resolvedAsset != null && resolvedAsset.resolvedBy !== HOME_BRIDGE_RESOLVED_BY) {
-      removeSupersededHomeBridgeSkill(resolvedAsset.displayName)
-    }
-    return resolvedAsset
-  }
-
   const addAsset = async (asset: SkillAsset): Promise<void> => {
     if (params.excludedIds?.has(asset.id)) return
     if (seen.has(asset.id)) return
@@ -311,25 +223,15 @@ export const expandSkillAssetDependenciesWithRemoteResolution = async (
         continue
       }
 
-      // Keep registry-backed dependencies ahead of home-bridge skills. We only
-      // fall back to a bridged home skill for plain-name dependencies when the
-      // registry path is unavailable.
-      const dependencyAsset = await installDependencyAsset(dependency, asset.instancePath).catch((error: unknown) => {
-        if (
-          localOrBridgedDependency != null &&
-          dependency.source == null
-        ) {
-          return localOrBridgedDependency
-        }
-        throw error
-      }) ?? (
-        dependency.source == null
-          ? localOrBridgedDependency
-          : undefined
-      )
+      const dependencyAsset = dependency.source == null
+        ? localOrBridgedDependency
+        : undefined
 
       if (dependencyAsset == null) {
-        throw new Error(`Failed to resolve skill dependency ${dependency.ref} declared by ${asset.displayName}`)
+        throw new Error(
+          `Skill dependency ${dependency.ref} declared by ${asset.displayName} is missing. ` +
+            'Run vf skills install or vf skills update to materialize project skill dependencies.'
+        )
       }
       await addAsset(dependencyAsset)
     }

package/src/skills-cli-dependency.ts

@@ -14,17 +14,33 @@ import {
   withInstallLock
 } from './skills-cli-dependency-helpers'
 
+const resolveAutoDownloadDependenciesEnabled = (
+  projectConfig: Config | undefined,
+  userConfig: Config | undefined
+) => userConfig?.skills?.autoDownloadDependencies ?? projectConfig?.skills?.autoDownloadDependencies ?? true
+
 export const installSkillsCliDependency = async (params: {
   cwd: string
   configs: [Config?, Config?]
   dependency: NormalizedSkillDependency
 }) => {
-  const resolvedTarget = params.dependency.source != null
-    ? {
-      skill: params.dependency.name,
-      source: params.dependency.source
+  const [projectConfig, userConfig] = params.configs
+  const autoDownloadDependenciesEnabled = resolveAutoDownloadDependenciesEnabled(projectConfig, userConfig)
+  const resolvedTarget = await (async () => {
+    if (params.dependency.source != null) {
+      return {
+        skill: params.dependency.name,
+        source: params.dependency.source
+      }
+    }
+
+    if (!autoDownloadDependenciesEnabled) {
+      throw new Error(
+        `Skill dependency automatic downloads are disabled; cannot resolve ${params.dependency.ref} without a source`
+      )
     }
-    : await (async () => {
+
+    return await (async () => {
       const searchResults = await findSkillsCli({
         registry: params.dependency.registry,
         query: params.dependency.name
@@ -40,6 +56,7 @@ export const installSkillsCliDependency = async (params: {
         source: selected.source
       }
     })()
+  })()
 
   const installDir = buildInstallDir({
     cwd: params.cwd,
@@ -58,6 +75,10 @@ export const installSkillsCliDependency = async (params: {
       }
     }
 
+    if (!autoDownloadDependenciesEnabled) {
+      throw new Error(`Skill dependency automatic downloads are disabled; cache not found for ${params.dependency.ref}`)
+    }
+
     const tempInstallDir = `${installDir}.tmp-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`
     await rm(tempInstallDir, { recursive: true, force: true })
     await mkdir(tempInstallDir, { recursive: true })

package/src/task-tool-guidance.ts

@@ -1,13 +1,27 @@
-export const buildManagedTaskToolGuidance = (serverName: string) => {
+export const buildManagedTaskToolGuidance = () => {
   return [
-    'Task tool guide:',
-    `- Use \`${serverName}.StartTasks\` to start a new child task when the work should run in a separate entity or workspace, or when it needs to continue independently from the current turn.`,
-    `- After starting a task, use \`${serverName}.GetTaskInfo\` with \`{ taskId }\` to inspect one task. It is also the right tool when a task seems stalled, failed, or might be waiting for input.`,
-    '- By default, `GetTaskInfo` returns the 10 most recent log entries in descending order, so newer entries appear earlier in the `logs` array. Pass `logLimit` to inspect a different number of recent logs, and set `logOrder` to `"asc"` when you want the selected log window in oldest-to-newest order.',
-    `- Use \`${serverName}.ListTasks\` with the same \`logLimit\` and \`logOrder\` fields when you need to find a taskId or inspect multiple tasks at once.`,
-    `- Use \`${serverName}.SendTaskMessage\` with \`{ taskId, message }\` when you need to give a task another instruction. Running tasks continue immediately; completed or failed tasks resume the same conversation instead of forcing a replacement task.`,
-    `- Use \`${serverName}.SubmitTaskInput\` only when \`${serverName}.GetTaskInfo\` or \`${serverName}.ListTasks\` shows \`pendingInput\` or \`pendingInteraction\`, or the task status is \`waiting_input\`. Do not use it for ordinary follow-up instructions.`,
-    `- If a task is \`completed\` or \`failed\` but you want to keep working in that same thread of execution, prefer \`${serverName}.SendTaskMessage\` to resume it. Start a new task only when you actually want a replacement task.`,
-    '- When a task is still making progress, use `wait` between checks instead of repeatedly restarting it.'
+    'Agent runtime guide:',
+    '- Use unified CLI protocol mode, `vf run --input-format stream-json --output-format stream-json`, to start a child runtime session when the work should run in a separate entity or continue independently from the current turn.',
+    '- Send typed runtime protocol envelopes such as `session.start`, `session.message`, `session.status`, `session.events`, `session.submit`, and `session.stop`; do not treat dedicated `vf agent ...` subcommands as the standard integration surface.',
+    '- Ordinary new sessions stay session-scoped. A room is created or discovered only when a unified CLI runtime protocol start command launches a child runtime session from a server-managed host session and the server projects runtime store metadata/events.',
+    '- Do not use MCP task tools, `vf agent ...`, legacy StartTasks, hand-written DB edits, or ad-hoc TS scripts as the task consumer surface. Use CLI protocol mode and the runtime protocol/store for start, status, events, follow-up messages, input submission, and cancellation.',
+    '- Server-managed host sessions inject the current adapter, model, effort, and permission mode as runtime protocol defaults. Omit these fields to inherit the host selection, or set them explicitly only when a child task must use a different runtime profile.',
+    '- Copyable JSONL example; write one `session.start` line per child task, and use multiple lines for multiple subtasks:',
+    '```bash',
+    "cat <<'JSONL' | vf run --input-format stream-json --output-format stream-json",
+    '{"commandId":"start-planner","type":"session.start","payload":{"title":"Plan Agent Room UI fix","message":"Plan the frontend changes and tests for the Agent Room UI fix.","entity":"dev-planner","background":true},"title":"Plan Agent Room UI fix","message":"Plan the frontend changes and tests for the Agent Room UI fix.","entity":"dev-planner","background":true}',
+    '{"commandId":"start-reviewer","type":"session.start","payload":{"title":"Review Agent Room UI fix","message":"Review the implemented Agent Room UI fix for regressions and missing tests.","entity":"dev-reviewer","background":true},"title":"Review Agent Room UI fix","message":"Review the implemented Agent Room UI fix for regressions and missing tests.","entity":"dev-reviewer","background":true}',
+    'JSONL',
+    '```',
+    '- Keep `payload.title`, `payload.message`, `payload.entity`, and `payload.background: true` explicit in each start envelope. The mirrored top-level fields make the JSONL executable by the current `vf run` protocol reader.',
+    '- Include a short `title` when the task prompt is long; it becomes the child session title and room run label. Put any room or workspace context in the title and initial message.',
+    '- Read the returned `sessionId` and use it for follow-up protocol commands. Read the latest runtime snapshot from the runtime store or a `session.status` protocol command, and read progress from runtime events or a `session.events` protocol command.',
+    '- Use a follow/read-events workflow when you need to watch progress instead of repeatedly restarting work.',
+    '- Use a `session.message` protocol command to give an existing session another instruction. Running sessions continue immediately; completed or failed sessions resume the same conversation when the runtime allows resume.',
+    '- When the chat UI sends a `[ROOM_TASK_MESSAGE] ... [/ROOM_TASK_MESSAGE]` block, treat it as a runtime relay envelope instead of ordinary prose. Parse the `sessionId` or legacy `taskId`, `message`, and optional `mode` / `request` fields. If the envelope indicates `mode: interaction`, or runtime status shows `waiting_input` / pending input, use a `session.submit` protocol command. Otherwise use `session.message`. Do not reply inline instead of routing the relay.',
+    '- Use `session.submit` only when a runtime session is waiting for an explicit input or approval request. Do not use it for ordinary follow-up instructions.',
+    '- Use a `session.stop` protocol command for graceful cancellation and set `mode` to `force` only when stop cannot recover the session.',
+    '- Compatibility aliases such as `vf agent start/status/events/send/submit/stop` may exist for debugging or legacy scripts, but they are not the primary guidance for new agent workflows.',
+    '- When a session is still making progress, use `wait` between checks and inspect status/events instead of starting a replacement session.'
   ].join('\n')
 }

package/src/workspace-prompt.ts

@@ -1,5 +1,5 @@
 import type { WorkspaceDefinitionPayload } from '@vibe-forge/types'
-import { CANONICAL_VIBE_FORGE_MCP_SERVER_NAME, resolvePromptPath } from '@vibe-forge/utils'
+import { resolvePromptPath } from '@vibe-forge/utils'
 
 import { buildManagedTaskToolGuidance } from './task-tool-guidance'
 
@@ -8,7 +8,7 @@ export const generateWorkspaceRoutePrompt = (
   workspaces: WorkspaceDefinitionPayload[]
 ) => {
   if (workspaces.length === 0) return ''
-  const taskToolGuidance = buildManagedTaskToolGuidance(CANONICAL_VIBE_FORGE_MCP_SERVER_NAME)
+  const taskToolGuidance = buildManagedTaskToolGuidance()
 
   const workspaceList = workspaces
     .map((workspace) => {
@@ -25,7 +25,7 @@ export const generateWorkspaceRoutePrompt = (
     '<system-prompt>\n' +
     'The project includes the following registered workspaces:\n' +
     `${workspaceList}\n` +
-    `When a user request targets one of these workspaces, start a child task with \`${CANONICAL_VIBE_FORGE_MCP_SERVER_NAME}.StartTasks\` using \`type: "workspace"\` and \`name\` set to the workspace identifier. ` +
+    'When a user request targets one of these workspaces, start a child runtime session with `vf run --input-format stream-json --output-format stream-json` and a `session.start` envelope; include the workspace identifier and path in the title and message. ' +
     'Do not directly edit files inside a registered workspace from the current session unless the user explicitly asks this session to work in that directory.\n' +
     `${taskToolGuidance}\n` +
     '</system-prompt>\n'