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

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.0",
   "description": "Workspace asset resolution and adapter asset planning for Vibe Forge",
   "imports": {
     "#~/*.js": {
@@ -25,19 +25,19 @@
     },
     "./package.json": "./package.json"
   },
+  "scripts": {
+    "test": "pnpm -C ../.. exec vitest run --workspace vitest.workspace.ts --project bundler packages/workspace-assets/__tests__"
+  },
   "dependencies": {
+    "@vibe-forge/config": "workspace:^",
+    "@vibe-forge/definition-core": "workspace:^",
+    "@vibe-forge/types": "workspace:^",
+    "@vibe-forge/utils": "workspace:^",
     "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"
+    "js-yaml": "^4.1.1"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9"
-  },
-  "scripts": {
-    "test": "pnpm -C ../.. exec vitest run --workspace vitest.workspace.ts --project bundler packages/workspace-assets/__tests__"
   }
-}
+}

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

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025-present Vibe-Forge.ai
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.