@vibe-forge/workspace-assets 0.9.0 → 0.9.1

package/AGENTS.md

@@ -15,6 +15,8 @@
   - `resolveWorkspaceAssetBundle()`
 - `src/prompt-selection.ts`
   - `resolvePromptAssetSelection()`
+- `src/prompt-builders.ts`
+  - rules / skills / specs / entities prompt 文本渲染
 - `src/adapter-asset-plan.ts`
   - `buildAdapterAssetPlan()`
 - `__tests__/bundle.spec.ts`
@@ -28,6 +30,7 @@
 - 本包负责：
   - workspace asset bundle 组装
   - prompt asset 选择
+  - prompt 文本拼装
   - adapter asset plan 组装
 - 本包不负责：
   - 定义文档发现与解析
@@ -37,7 +40,7 @@
 ## 维护约定
 
 - 只维护 workspace asset 领域逻辑；定义文档读取留在 `@vibe-forge/definition-loader`，cache 留在 `@vibe-forge/utils`。
-- 文档路径规范化与命名规则复用 `@vibe-forge/utils/document-path`，不要在本包重复维护。
+- 通用路径处理复用 `@vibe-forge/utils`；definition 名称/标识/摘要与 remote rule 投影复用 `@vibe-forge/definition-core`；prompt builder 仍留在本包内维护。
 - 共享 contract 继续依赖 `@vibe-forge/types`，不要把 task / hooks / mcp 逻辑反向塞进来。
 - 新增 asset 类型、prompt 选择规则或 adapter 投影时，优先补对应职责下的 spec 文件，不要继续把单测堆回一个综合 spec。
 - 影响 bundle / prompt selection / adapter plan 整体投影时，同步检查 `workspace-assets-rich.snapshot.json`；必要时用 `pnpm -C packages/workspace-assets test -- --update` 更新快照。

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

@@ -467,7 +467,7 @@
       ]
     },
     "options": {
-      "systemPrompt": "<system-prompt>\n项目系统规则如下：\n# review\n\n> 必须检查发布改动的回归风险。\n\n# demo/security\n\n> 适用场景：插件安全规则\n> 规则文件路径：node_modules/@vibe-forge/plugin-demo/rules/security.md\n> 仅在任务满足上述场景时，再阅读该规则文件。\n</system-prompt>\n\n\n<system-prompt>\n项目已加载如下技能模块：\n# research\n\n> 技能介绍：检索资料\n> 技能文件路径：.ai/skills/research/SKILL.md\n> 资源内容中的相对路径相对该技能文件所在目录解析。\n\n<skill-content>\n先阅读 README.md，再补充结论。\n</skill-content>\n</system-prompt>\n\n\n<system-prompt>\n项目存在如下实体：\n  - architect：负责拆解方案的实体\n\n解决用户问题时，需根据用户需求可以通过 run-tasks 工具指定为实体后，自行调度多个不同类型的实体来完成工作。\n</system-prompt>\n\n\n\n\n<system-prompt>\n你是一个专业的项目推进管理大师，能够熟练指导其他实体来为你的目标工作。对你的预期是：\n\n- 永远不要单独完成代码开发工作\n- 必须要协调其他的开发人员来完成任务\n- 必须让他们按照目标进行完成，不要偏离目标，检查他们任务完成后的汇报内容是否符合要求\n\n根据用户需要以及实际的开发目标来决定使用不同的工作流程，调用 `load-spec` mcp tool 完成工作流程的加载。\n- 根据实际需求传入标识，这不是路径，只能使用工具进行加载\n- 通过参数的描述以及实际应用场景决定怎么传入参数\n项目存在如下工作流程：\n- 流程名称：release\n  - 介绍：正式发布流程\n  - 标识：release\n  - 参数：\n    - 无\n\n- 流程名称：demo/release\n  - 介绍：插件发布流程\n  - 标识：demo/release\n  - 参数：\n    - 无\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 specify entities through `vibe-forge.StartTasks` as needed and have them coordinate multiple entity types to complete the work; use `GetTaskInfo` and `wait` to track progress when needed.\n</system-prompt>\n\n\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 resolve the matching definition by workflow identifier.\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

@@ -11,17 +11,25 @@ describe('buildAdapterAssetPlan', () => {
     const workspace = await createWorkspace()
 
     await installPluginPackage(workspace, '@vibe-forge/plugin-logger', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-logger',
-        version: '1.0.0'
-      }, null, 2),
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-logger',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
       'hooks.js': 'module.exports = {}\n'
     })
     await installPluginPackage(workspace, '@vibe-forge/plugin-demo', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-demo',
-        version: '1.0.0'
-      }, null, 2),
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-demo',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
       'opencode/commands/review.md': '# review\n'
     })
     await writeDocument(
@@ -118,10 +126,14 @@ describe('buildAdapterAssetPlan', () => {
     const workspace = await createWorkspace()
 
     await installPluginPackage(workspace, '@vibe-forge/plugin-demo', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-demo',
-        version: '1.0.0'
-      }, null, 2),
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-demo',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
       'opencode/commands/review.md': '# review\n'
     })
     await writeDocument(

package/__tests__/bundle.spec.ts

@@ -11,20 +11,28 @@ describe('resolveWorkspaceAssetBundle', () => {
     const workspace = await createWorkspace()
 
     await installPluginPackage(workspace, '@vibe-forge/plugin-demo', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-demo',
-        version: '1.0.0'
-      }, null, 2),
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-demo',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
       'skills/research/SKILL.md': '---\ndescription: 检索资料\n---\n阅读 README.md',
       'rules/review.md': '---\ndescription: 评审规则\n---\n必须检查风险',
       'mcp/browser.json': JSON.stringify({ command: 'npx', args: ['browser-server'] }, null, 2),
       'opencode/commands/review.md': '# review\n'
     })
     await installPluginPackage(workspace, '@vibe-forge/plugin-logger', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-logger',
-        version: '1.0.0'
-      }, null, 2),
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-logger',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
       'hooks.js': 'module.exports = {}\n'
     })
 
@@ -87,17 +95,25 @@ describe('resolveWorkspaceAssetBundle', () => {
     const workspace = await createWorkspace()
 
     await installPluginPackage(workspace, '@vibe-forge/plugin-demo', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-demo',
-        version: '1.0.0'
-      }, null, 2),
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-demo',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
       'skills/research/SKILL.md': '---\ndescription: 检索资料\n---\n阅读 README.md'
     })
     await installPluginPackage(workspace, '@vibe-forge/plugin-bundle', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-bundle',
-        version: '1.0.0'
-      }, null, 2),
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-bundle',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
       'index.js': [
         'module.exports = {',
         '  __vibeForgePluginManifest: true,',
@@ -112,10 +128,14 @@ describe('resolveWorkspaceAssetBundle', () => {
       ].join('\n')
     })
     await installPluginPackage(workspace, '@vibe-forge/plugin-review', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-review',
-        version: '1.0.0'
-      }, null, 2),
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-review',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
       'skills/audit/SKILL.md': '---\ndescription: 代码审计\n---\n检查 child plugin 是否启用'
     })
 
@@ -144,10 +164,14 @@ describe('resolveWorkspaceAssetBundle', () => {
     const workspace = await createWorkspace()
 
     await installPluginPackage(workspace, '@vibe-forge/plugin-logger', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-logger',
-        version: '1.0.0'
-      }, null, 2),
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-logger',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
       'hooks.js': 'module.exports = {}\n'
     })
 
@@ -179,13 +203,17 @@ describe('resolveWorkspaceAssetBundle', () => {
     const workspace = await createWorkspace()
 
     await installPluginPackage(workspace, '@vibe-forge/plugin-bad-manifest', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-bad-manifest',
-        version: '1.0.0',
-        exports: {
-          '.': './index.js'
-        }
-      }, null, 2),
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-bad-manifest',
+          version: '1.0.0',
+          exports: {
+            '.': './index.js'
+          }
+        },
+        null,
+        2
+      ),
       'index.js': [
         'module.exports = {',
         '  __vibeForgePluginManifest: true,',

package/__tests__/prompt-builders.spec.ts

@@ -0,0 +1,198 @@
+import { join } from 'node:path'
+
+import { describe, expect, it } from 'vitest'
+
+import {
+  generateEntitiesRoutePrompt,
+  generateRulesPrompt,
+  generateSkillsPrompt,
+  generateSkillsRoutePrompt,
+  generateSpecRoutePrompt
+} from '#~/prompt-builders.js'
+
+describe('workspace asset prompt builders', () => {
+  it('builds skill prompts with stable names, descriptions, and relative paths', () => {
+    const cwd = '/tmp/project'
+
+    const prompt = generateSkillsPrompt(cwd, [
+      {
+        path: join(cwd, '.ai/skills/research/SKILL.md'),
+        body: '阅读 README.md\n',
+        attributes: {
+          description: '检索项目信息'
+        }
+      }
+    ])
+
+    expect(prompt).toContain('The following skill modules are loaded for the project')
+    expect(prompt).toContain('# research')
+    expect(prompt).toContain('> Skill description: 检索项目信息')
+    expect(prompt).toContain('> Skill file path: .ai/skills/research/SKILL.md')
+    expect(prompt).toContain('<skill-content>')
+    expect(prompt).not.toContain('/tmp/project/.ai/skills/research/SKILL.md')
+  })
+
+  it('builds rules prompts with embedded always rules and summary-only optional rules', () => {
+    const cwd = '/tmp/project'
+
+    const prompt = generateRulesPrompt(cwd, [
+      {
+        path: join(cwd, '.ai/rules/base.md'),
+        body: '始终检查公共边界。',
+        attributes: {
+          alwaysApply: true
+        }
+      },
+      {
+        path: join(cwd, '.ai/rules/optional.md'),
+        body: '仅在需要时展开。',
+        attributes: {
+          description: '按需规则',
+          alwaysApply: false
+        }
+      }
+    ])
+
+    expect(prompt).toContain('# base')
+    expect(prompt).toContain('> 始终检查公共边界。')
+    expect(prompt).toContain('> Use when: 按需规则')
+    expect(prompt).toContain('> Rule file path: .ai/rules/optional.md')
+    expect(prompt).not.toContain('> 仅在需要时展开。')
+  })
+
+  it('builds rule prompts with markdown headings and blockquotes', () => {
+    const cwd = '/tmp/project'
+
+    const prompt = generateRulesPrompt(cwd, [
+      {
+        path: join(cwd, '.ai/rules/required.md'),
+        body: '# 标题\n\n正文',
+        attributes: {
+          alwaysApply: true
+        }
+      },
+      {
+        path: join(cwd, '.ai/rules/summary-only.md'),
+        body: '不应该内联',
+        attributes: {
+          description: '只展示摘要',
+          alwaysApply: false
+        }
+      }
+    ])
+
+    expect(prompt).toContain('# required')
+    expect(prompt).toContain('> # 标题')
+    expect(prompt).toContain('> 正文')
+    expect(prompt).toContain('# summary-only')
+    expect(prompt).toContain('> Use when: 只展示摘要')
+    expect(prompt).toContain('> Rule file path: .ai/rules/summary-only.md')
+    expect(prompt).not.toContain('> 不应该内联')
+    expect(prompt).not.toContain('--------------------')
+  })
+
+  it('builds spec route prompts with logical identifiers and active identity guidance', () => {
+    const cwd = '/tmp/project'
+
+    const prompt = generateSpecRoutePrompt([
+      {
+        path: join(cwd, '.ai/specs/release/index.md'),
+        body: '发布流程',
+        attributes: {
+          params: [
+            {
+              name: 'version',
+              description: '版本号'
+            }
+          ]
+        }
+      }
+    ], { active: true })
+
+    expect(prompt).toContain('professional project execution manager')
+    expect(prompt).toContain('Workflow name: release')
+    expect(prompt).toContain('Identifier: release')
+    expect(prompt).toContain('    - version: 版本号')
+  })
+
+  it('builds spec route prompts without exposing file paths', () => {
+    const cwd = '/tmp/project'
+
+    const prompt = generateSpecRoutePrompt([
+      {
+        path: join(cwd, '.ai/specs/release/index.md'),
+        body: '发布流程\n执行发布任务',
+        attributes: {
+          params: [
+            {
+              name: 'version',
+              description: '版本号'
+            }
+          ]
+        }
+      },
+      {
+        path: join(cwd, '.ai/specs/internal.md'),
+        body: '内部流程',
+        attributes: {
+          always: false
+        }
+      }
+    ])
+
+    expect(prompt).toContain('Workflow name: release')
+    expect(prompt).toContain('Description: 发布流程')
+    expect(prompt).toContain('Identifier: release')
+    expect(prompt).toContain('    - version: 版本号')
+    expect(prompt).not.toContain('professional project execution manager')
+    expect(prompt).not.toContain('.ai/specs/release/index.md')
+    expect(prompt).not.toContain('internal')
+  })
+
+  it('builds entity routes from summaries instead of full bodies', () => {
+    const cwd = '/tmp/project'
+
+    const prompt = generateEntitiesRoutePrompt([
+      {
+        path: join(cwd, '.ai/entities/reviewer/README.md'),
+        body: '负责代码审查\n需要关注变更风险',
+        attributes: {}
+      },
+      {
+        path: join(cwd, '.ai/entities/hidden.md'),
+        body: '不应暴露',
+        attributes: {
+          name: 'hidden',
+          always: false
+        }
+      }
+    ])
+
+    expect(prompt).toContain('reviewer: 负责代码审查')
+    expect(prompt).not.toContain('需要关注变更风险')
+    expect(prompt).not.toContain('hidden')
+  })
+
+  it('builds skill route prompts without preloading content', () => {
+    const cwd = '/tmp/project'
+
+    const prompt = generateSkillsRoutePrompt(cwd, [
+      {
+        path: join(cwd, '.ai/skills/research/SKILL.md'),
+        body: '阅读 README.md\n',
+        attributes: {
+          description: '检索项目信息'
+        }
+      }
+    ])
+
+    expect(prompt).toContain('# research')
+    expect(prompt).toContain('> Skill description: 检索项目信息')
+    expect(prompt).toContain('> Skill file path: .ai/skills/research/SKILL.md')
+    expect(prompt).toContain(
+      '> Do not preload the body by default; read the corresponding skill file only when the task clearly requires it.'
+    )
+    expect(prompt).not.toContain('<skill-content>')
+    expect(prompt).not.toContain('阅读 README.md')
+  })
+})

package/__tests__/prompt-selection.spec.ts

@@ -43,9 +43,9 @@ describe('resolvePromptAssetSelection', () => {
     expect(options.systemPrompt).toContain('# base')
     expect(options.systemPrompt).toContain('> 始终检查公共边界。')
     expect(options.systemPrompt).toContain('# optional')
-    expect(options.systemPrompt).toContain('> 适用场景：按需参考规则')
-    expect(options.systemPrompt).toContain('> 规则文件路径：.ai/rules/optional.md')
-    expect(options.systemPrompt).toContain('> 仅在任务满足上述场景时，再阅读该规则文件。')
+    expect(options.systemPrompt).toContain('> Use when: 按需参考规则')
+    expect(options.systemPrompt).toContain('> Rule file path: .ai/rules/optional.md')
+    expect(options.systemPrompt).toContain('> Only read this rule file when the task matches the scenario above.')
     expect(options.systemPrompt).not.toContain('> 只有在特定场景才需要展开。')
   })
 
@@ -144,8 +144,8 @@ describe('resolvePromptAssetSelection', () => {
     expect(resolvedOptions.systemPrompt).toContain('> 正文第一行')
     expect(resolvedOptions.systemPrompt).toContain('> 正文第二行')
     expect(resolvedOptions.systemPrompt).toContain('# summary-only')
-    expect(resolvedOptions.systemPrompt).toContain('> 适用场景：只展示摘要')
-    expect(resolvedOptions.systemPrompt).toContain('> 规则文件路径：.ai/rules/summary-only.md')
+    expect(resolvedOptions.systemPrompt).toContain('> Use when: 只展示摘要')
+    expect(resolvedOptions.systemPrompt).toContain('> Rule file path: .ai/rules/summary-only.md')
     expect(resolvedOptions.systemPrompt).not.toContain('> 不应该出现在引用正文里')
     expect(resolvedOptions.systemPrompt).not.toContain('--------------------')
   })
@@ -194,14 +194,16 @@ describe('resolvePromptAssetSelection', () => {
     })
 
     expect(data.targetSkills.map(skill => skill.resolvedName ?? skill.attributes.name)).toEqual(['research'])
-    expect(options.systemPrompt).toContain('项目已加载如下技能模块')
+    expect(options.systemPrompt).toContain('The following skill modules are loaded for the project')
     expect(options.systemPrompt).toContain('# research')
-    expect(options.systemPrompt).toContain('> 技能文件路径：.ai/skills/research/SKILL.md')
+    expect(options.systemPrompt).toContain('> Skill file path: .ai/skills/research/SKILL.md')
     expect(options.systemPrompt).toContain('<skill-content>')
     expect(options.systemPrompt).toContain('先读 README.md')
     expect(options.systemPrompt).toContain('# review')
-    expect(options.systemPrompt).toContain('> 技能文件路径：.ai/skills/review/SKILL.md')
-    expect(options.systemPrompt).toContain('> 默认无需预先加载正文；仅在任务明确需要该技能时，再读取对应技能文件。')
+    expect(options.systemPrompt).toContain('> Skill file path: .ai/skills/review/SKILL.md')
+    expect(options.systemPrompt).toContain(
+      '> Do not preload the body by default; read the corresponding skill file only when the task clearly requires it.'
+    )
     expect(options.systemPrompt).not.toContain('<skill-content>\n检查回归风险\n</skill-content>')
   })
 
@@ -228,11 +230,13 @@ describe('resolvePromptAssetSelection', () => {
     })
 
     expect(data.targetSkills).toEqual([])
-    expect(options.systemPrompt).not.toContain('项目已加载如下技能模块')
+    expect(options.systemPrompt).not.toContain('The following skill modules are loaded for the project')
     expect(options.systemPrompt).toContain('<skills>')
     expect(options.systemPrompt).toContain('# research')
-    expect(options.systemPrompt).toContain('> 技能文件路径：.ai/skills/research/SKILL.md')
-    expect(options.systemPrompt).toContain('> 默认无需预先加载正文；仅在任务明确需要该技能时，再读取对应技能文件。')
+    expect(options.systemPrompt).toContain('> Skill file path: .ai/skills/research/SKILL.md')
+    expect(options.systemPrompt).toContain(
+      '> Do not preload the body by default; read the corresponding skill file only when the task clearly requires it.'
+    )
     expect(options.systemPrompt).not.toContain('<skill-content>')
     expect(options.systemPrompt).not.toContain('先读 README.md')
   })
@@ -259,9 +263,9 @@ describe('resolvePromptAssetSelection', () => {
       type: undefined
     })
 
-    expect(options.systemPrompt).toContain('项目存在如下工作流程')
-    expect(options.systemPrompt).toContain('流程名称：release')
-    expect(options.systemPrompt).not.toContain('项目推进管理大师')
+    expect(options.systemPrompt).toContain('The project includes the following workflows')
+    expect(options.systemPrompt).toContain('Workflow name: release')
+    expect(options.systemPrompt).not.toContain('professional project execution manager')
   })
 
   it('injects spec identity guidance when a spec is actively selected', async () => {
@@ -287,9 +291,9 @@ describe('resolvePromptAssetSelection', () => {
       name: 'release'
     })
 
-    expect(options.systemPrompt).toContain('项目推进管理大师')
-    expect(options.systemPrompt).toContain('永远不要单独完成代码开发工作')
-    expect(options.systemPrompt).toContain('流程名称：release')
+    expect(options.systemPrompt).toContain('professional project execution manager')
+    expect(options.systemPrompt).toContain('Never complete code development work alone')
+    expect(options.systemPrompt).toContain('Workflow name: release')
   })
 
   it('embeds referenced skills for entity mode and removes them from route guidance', async () => {
@@ -336,14 +340,14 @@ describe('resolvePromptAssetSelection', () => {
     })
 
     expect(data.targetSkills.map(skill => skill.resolvedName ?? skill.attributes.name)).toEqual(['review'])
-    expect(options.systemPrompt).toContain('项目已加载如下技能模块')
+    expect(options.systemPrompt).toContain('The following skill modules are loaded for the project')
     expect(options.systemPrompt).toContain('# review')
     expect(options.systemPrompt).toContain('<skill-content>')
     expect(options.systemPrompt).toContain('检查回归风险')
     expect(options.systemPrompt).not.toContain('<skills>\n# review')
     expect(options.systemPrompt).toContain('<skills>')
     expect(options.systemPrompt).toContain('# research')
-    expect(options.systemPrompt).toContain('> 技能文件路径：.ai/skills/research/SKILL.md')
+    expect(options.systemPrompt).toContain('> Skill file path: .ai/skills/research/SKILL.md')
     expect(options.systemPrompt).not.toContain('<skill-content>\n先读 README.md\n</skill-content>')
   })
 
@@ -380,9 +384,9 @@ describe('resolvePromptAssetSelection', () => {
     })
 
     expect(data.targetSkills).toEqual([])
-    expect(options.systemPrompt).not.toContain('项目已加载如下技能模块')
+    expect(options.systemPrompt).not.toContain('The following skill modules are loaded for the project')
     expect(options.systemPrompt).toContain('# research')
-    expect(options.systemPrompt).toContain('> 技能文件路径：.ai/skills/research/SKILL.md')
+    expect(options.systemPrompt).toContain('> Skill file path: .ai/skills/research/SKILL.md')
     expect(options.systemPrompt).not.toContain('先读 README.md')
   })
 })

package/__tests__/snapshot.ts

@@ -1,5 +1,6 @@
 import process from 'node:process'
 
+import { resolveDocumentName, resolveSpecIdentifier } from '@vibe-forge/definition-core'
 import type {
   AdapterAssetPlan,
   AssetDiagnostic,
@@ -14,7 +15,6 @@ import type {
   WorkspaceAssetBundle,
   WorkspaceAssetKind
 } from '@vibe-forge/types'
-import { resolveDocumentName, resolveSpecIdentifier } from '@vibe-forge/utils'
 
 const sortStrings = (values: string[]) => [...values].sort((left, right) => left.localeCompare(right))
 
@@ -94,7 +94,9 @@ const buildSnapshotAssetId = (
   asset: WorkspaceAsset,
   cwd: string
 ) => (
-  `${asset.kind}:${asset.origin}:${asset.instancePath ?? 'workspace'}:${asset.displayName}:${sanitizeValue(asset.sourcePath, cwd)}`
+  `${asset.kind}:${asset.origin}:${asset.instancePath ?? 'workspace'}:${asset.displayName}:${
+    sanitizeValue(asset.sourcePath, cwd)
+  }`
 )
 
 const summarizeBaseAsset = (

package/__tests__/test-helpers.ts

@@ -23,9 +23,11 @@ export const installPluginPackage = async (
   files: Record<string, string>
 ) => {
   const packageDir = join(workspace, 'node_modules', ...packageName.split('/'))
-  await Promise.all(Object.entries(files).map(async ([relativePath, content]) => {
-    await writeDocument(join(packageDir, relativePath), content)
-  }))
+  await Promise.all(
+    Object.entries(files).map(async ([relativePath, content]) => {
+      await writeDocument(join(packageDir, relativePath), content)
+    })
+  )
 }
 
 afterEach(async () => {

package/__tests__/workspace-assets.snapshot.spec.ts

@@ -56,10 +56,14 @@ describe('workspace assets snapshots', () => {
     }
 
     await installPluginPackage(workspace, '@vibe-forge/plugin-demo', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-demo',
-        version: '1.0.0'
-      }, null, 2),
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-demo',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
       'hooks.js': 'module.exports = {}\n',
       'rules/security.md': [
         '---',
@@ -94,17 +98,25 @@ describe('workspace assets snapshots', () => {
       'opencode/plugins/demo-plugin.js': 'export default {}\n'
     })
     await installPluginPackage(workspace, '@vibe-forge/plugin-logger', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-logger',
-        version: '1.0.0'
-      }, null, 2),
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-logger',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
       'hooks.js': 'module.exports = {}\n'
     })
     await installPluginPackage(workspace, '@vibe-forge/plugin-telemetry', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-telemetry',
-        version: '1.0.0'
-      }, null, 2),
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-telemetry',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
       'hooks.js': 'module.exports = {}\n'
     })
 

package/package.json

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