@vibe-forge/workspace-assets 0.10.0 → 0.10.1-alpha.1

package/__tests__/prompt-selection.spec.ts

@@ -241,6 +241,90 @@ describe('resolvePromptAssetSelection', () => {
     expect(options.systemPrompt).not.toContain('先读 README.md')
   })
 
+  it('omits route-only project skills when the adapter provides native skill loading', async () => {
+    const workspace = await createWorkspace()
+
+    await writeDocument(
+      join(workspace, '.ai/skills/research/SKILL.md'),
+      [
+        '---',
+        'description: 检索项目信息',
+        '---',
+        '先读 README.md'
+      ].join('\n')
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      useDefaultVibeForgeMcpServer: false
+    })
+    const [data, options] = await resolvePromptAssetSelection({
+      bundle,
+      adapter: 'claude-code',
+      type: undefined
+    })
+
+    expect(data.targetSkills).toEqual([])
+    expect(options.systemPrompt).not.toContain('<skills>')
+    expect(options.systemPrompt).not.toContain('# research')
+    expect(options.systemPrompt).not.toContain('Skill file path: .ai/skills/research/SKILL.md')
+    expect(options.promptAssetIds).not.toContain(bundle.skills[0]?.id)
+  })
+
+  it('keeps explicitly referenced skills embedded for adapters with native project skills', async () => {
+    const workspace = await createWorkspace()
+
+    await writeDocument(
+      join(workspace, '.ai/skills/research/SKILL.md'),
+      [
+        '---',
+        'description: 检索项目信息',
+        '---',
+        '先读 README.md'
+      ].join('\n')
+    )
+    await writeDocument(
+      join(workspace, '.ai/skills/review/SKILL.md'),
+      [
+        '---',
+        'description: 评审代码改动',
+        '---',
+        '检查回归风险'
+      ].join('\n')
+    )
+    await writeDocument(
+      join(workspace, '.ai/specs/release/index.md'),
+      [
+        '---',
+        'description: 发布流程',
+        'skills:',
+        '  - research',
+        '---',
+        '执行发布'
+      ].join('\n')
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      useDefaultVibeForgeMcpServer: false
+    })
+    const [data, options] = await resolvePromptAssetSelection({
+      bundle,
+      adapter: 'claude-code',
+      type: 'spec',
+      name: 'release'
+    })
+
+    expect(data.targetSkills.map(skill => skill.resolvedName ?? skill.attributes.name)).toEqual(['research'])
+    expect(options.systemPrompt).toContain('The following skill modules are loaded for the project')
+    expect(options.systemPrompt).toContain('# research')
+    expect(options.systemPrompt).toContain('<skill-content>')
+    expect(options.systemPrompt).toContain('先读 README.md')
+    expect(options.systemPrompt).not.toContain('<skills>')
+    expect(options.systemPrompt).not.toContain('# review')
+    expect(options.systemPrompt).not.toContain('Skill file path: .ai/skills/review/SKILL.md')
+  })
+
   it('keeps spec route guidance without default identity in normal mode', async () => {
     const workspace = await createWorkspace()
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-forge/workspace-assets",
-  "version": "0.10.0",
+  "version": "0.10.1-alpha.1",
   "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/definition-core": "^0.10.0",
     "@vibe-forge/config": "^0.10.0",
-    "@vibe-forge/types": "^0.10.0",
-    "@vibe-forge/utils": "^0.10.0"
+    "@vibe-forge/types": "^0.10.1",
+    "@vibe-forge/utils": "^0.10.1",
+    "@vibe-forge/definition-core": "^0.10.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9"

package/src/adapter-asset-plan.ts

@@ -10,6 +10,7 @@ import type {
   WorkspaceSkillSelection
 } from '@vibe-forge/types'
 
+import { resolveNativeSkillDiagnosticReason, supportsNativeProjectSkills } from './adapter-capabilities'
 import { resolveSelectedMcpNames, resolveSelectedSkillAssets } from './selection-internal'
 
 export function buildAdapterAssetPlan(params: {
@@ -83,13 +84,13 @@ export function buildAdapterAssetPlan(params: {
   })
 
   const selectedSkillAssets = resolveSelectedSkillAssets(params.bundle.skills, params.options.skills)
-  if (params.adapter === 'opencode') {
+  if (supportsNativeProjectSkills(params.adapter)) {
     selectedSkillAssets.forEach((asset) => {
       diagnostics.push({
         assetId: asset.id,
         adapter: params.adapter,
         status: 'native',
-        reason: 'Mirrored into OPENCODE_CONFIG_DIR as a native skill.',
+        reason: resolveNativeSkillDiagnosticReason(params.adapter),
         packageId: asset.packageId,
         scope: asset.scope,
         instancePath: asset.instancePath,
@@ -98,6 +99,8 @@ export function buildAdapterAssetPlan(params: {
         taskOverlaySource: asset.taskOverlaySource
       })
     })
+  }
+  if (params.adapter === 'opencode') {
     params.bundle.opencodeOverlayAssets.forEach((asset) => {
       diagnostics.push({
         assetId: asset.id,

package/src/adapter-capabilities.ts

@@ -0,0 +1,12 @@
+import type { WorkspaceAssetAdapter } from '@vibe-forge/types'
+
+const NATIVE_SKILL_ADAPTERS = new Set<WorkspaceAssetAdapter>(['claude-code', 'opencode'])
+
+export const supportsNativeProjectSkills = (adapter?: string): adapter is WorkspaceAssetAdapter =>
+  adapter != null && NATIVE_SKILL_ADAPTERS.has(adapter as WorkspaceAssetAdapter)
+
+export const resolveNativeSkillDiagnosticReason = (adapter: WorkspaceAssetAdapter) => (
+  adapter === 'claude-code'
+    ? 'Synced into the Claude mock home as a native skill.'
+    : 'Mirrored into OPENCODE_CONFIG_DIR as a native skill.'
+)

package/src/prompt-selection.ts

@@ -11,6 +11,7 @@ import type {
   WorkspaceSkillSelection
 } from '@vibe-forge/types'
 
+import { supportsNativeProjectSkills } from './adapter-capabilities'
 import { resolveWorkspaceAssetBundle } from './bundle'
 import {
   generateEntitiesRoutePrompt,
@@ -35,6 +36,7 @@ export async function resolvePromptAssetSelection(params: {
   bundle: WorkspaceAssetBundle
   type: 'spec' | 'entity' | undefined
   name?: string
+  adapter?: string
   input?: {
     skills?: WorkspaceSkillSelection
   }
@@ -83,10 +85,11 @@ export async function resolvePromptAssetSelection(params: {
   }
 
   const selectedSkillAssets = resolveSelectedSkillAssets(effectiveBundle.skills, params.input?.skills)
+  const useNativeProjectSkills = supportsNativeProjectSkills(params.adapter)
   const promptAssetIds = new Set<string>([
     ...effectiveBundle.rules.map(asset => asset.id),
     ...effectiveBundle.specs.map(asset => asset.id),
-    ...selectedSkillAssets.map(asset => asset.id),
+    ...(useNativeProjectSkills ? [] : selectedSkillAssets.map(asset => asset.id)),
     ...(params.type !== 'entity' ? effectiveBundle.entities.map(asset => asset.id) : [])
   ])
   const ruleDefinitions = new Map<string, Definition<Rule>>(
@@ -164,10 +167,12 @@ export async function resolvePromptAssetSelection(params: {
     generateRulesPrompt(effectiveBundle.cwd, rules),
     generateSkillsPrompt(effectiveBundle.cwd, targetSkills),
     generateEntitiesRoutePrompt(entities),
-    generateSkillsRoutePrompt(effectiveBundle.cwd, routedSkills),
+    useNativeProjectSkills ? '' : generateSkillsRoutePrompt(effectiveBundle.cwd, routedSkills),
     generateSpecRoutePrompt(specs, { active: params.type === 'spec' }),
     targetBody
-  ].join('\n\n')
+  ]
+    .filter(section => section !== '')
+    .join('\n\n')
 
   if (targetToolsFilter != null) {
     options.tools = targetToolsFilter