feat: 添加 skill learning 技能学习闭环系统

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: unraid

.gitignore

@@ -19,6 +19,11 @@ src/utils/vendor/
 /*.png
 *.bmp
 
+# Internal system prompt documents
+Claude-Opus-*.txt
+Claude-Sonnet-*.txt
+Claude-Haiku-*.txt
+
 # Agent / tool state dirs
 .swarm/
 .agents/__pycache__/

AGENTS.md

@@ -0,0 +1,107 @@
+import { z } from 'zod/v4'
+import type { ToolResultBlockParam } from 'src/Tool.js'
+import { buildTool } from 'src/Tool.js'
+import { lazySchema } from 'src/utils/lazySchema.js'
+import {
+  DISCOVER_SKILLS_TOOL_NAME,
+  DESCRIPTION,
+  DISCOVER_SKILLS_PROMPT,
+} from './prompt.js'
+
+const inputSchema = lazySchema(() =>
+  z.strictObject({
+    description: z
+      .string()
+      .describe(
+        'Description of what you want to do. Be specific — e.g. "deploy a Next.js app to Cloudflare Workers" rather than just "deploy".',
+      ),
+    limit: z
+      .number()
+      .optional()
+      .describe('Maximum number of results to return (default: 5)'),
+  }),
+)
+type InputSchema = ReturnType<typeof inputSchema>
+type DiscoverInput = z.infer<InputSchema>
+
+type DiscoverOutput = {
+  results: Array<{ name: string; description: string; score: number }>
+  count: number
+}
+
+export const DiscoverSkillsTool = buildTool({
+  name: DISCOVER_SKILLS_TOOL_NAME,
+  searchHint: 'find search discover skills commands tools capabilities',
+  maxResultSizeChars: 10_000,
+  strict: true,
+
+  get inputSchema(): InputSchema {
+    return inputSchema()
+  },
+
+  async description() {
+    return DESCRIPTION
+  },
+  async prompt() {
+    return DISCOVER_SKILLS_PROMPT
+  },
+
+  isConcurrencySafe() {
+    return true
+  },
+  isReadOnly() {
+    return true
+  },
+
+  userFacingName() {
+    return 'Discover Skills'
+  },
+
+  renderToolUseMessage(input: Partial<DiscoverInput>) {
+    return `Searching skills: ${input.description?.slice(0, 80) ?? '...'}`
+  },
+
+  mapToolResultToToolResultBlockParam(
+    content: DiscoverOutput,
+    toolUseID: string,
+  ): ToolResultBlockParam {
+    if (content.count === 0) {
+      return {
+        tool_use_id: toolUseID,
+        type: 'tool_result',
+        content: 'No matching skills found for that description.',
+      }
+    }
+    const lines = content.results.map(
+      (r, i) =>
+        `${i + 1}. **${r.name}** (score: ${r.score.toFixed(2)})\n   ${r.description}`,
+    )
+    return {
+      tool_use_id: toolUseID,
+      type: 'tool_result',
+      content: `Found ${content.count} relevant skill(s):\n\n${lines.join('\n\n')}`,
+    }
+  },
+
+  async call(input: DiscoverInput, context) {
+    const { getSkillIndex, searchSkills } = await import(
+      'src/services/skillSearch/localSearch.js'
+    )
+    const { getCwd } = await import('src/utils/cwd.js')
+    const cwd = getCwd()
+
+    const index = await getSkillIndex(cwd)
+    const results = searchSkills(input.description, index, input.limit ?? 5)
+
+    return {
+      data: {
+        results: results.map(r => ({
+          name: r.name,
+          description: r.description,
+          score: r.score,
+        })),
+        count: results.length,
+      },
+    }
+  },
+})

packages/builtin-tools/src/tools/DiscoverSkillsTool/DiscoverSkillsTool.ts

@@ -0,0 +1,54 @@
+import { describe, test, expect } from 'bun:test'
+import { DISCOVER_SKILLS_TOOL_NAME } from '../prompt.js'
+
+describe('DiscoverSkillsTool', () => {
+  test('DISCOVER_SKILLS_TOOL_NAME is not empty', () => {
+    expect(DISCOVER_SKILLS_TOOL_NAME).toBe('DiscoverSkills')
+    expect(DISCOVER_SKILLS_TOOL_NAME.length).toBeGreaterThan(0)
+  })
+
+  test('tool exports are functions', async () => {
+    const { DiscoverSkillsTool } = await import('../DiscoverSkillsTool.js')
+    expect(DiscoverSkillsTool).toBeDefined()
+    expect(DiscoverSkillsTool.name).toBe('DiscoverSkills')
+    expect(typeof DiscoverSkillsTool.call).toBe('function')
+  })
+
+  test('tool has correct metadata', async () => {
+    const { DiscoverSkillsTool } = await import('../DiscoverSkillsTool.js')
+    expect(await DiscoverSkillsTool.description()).toContain('skill')
+    expect(DiscoverSkillsTool.userFacingName()).toBe('Discover Skills')
+    expect(DiscoverSkillsTool.isReadOnly()).toBe(true)
+    expect(DiscoverSkillsTool.isConcurrencySafe()).toBe(true)
+  })
+
+  test('renderToolUseMessage formats input', async () => {
+    const { DiscoverSkillsTool } = await import('../DiscoverSkillsTool.js')
+    const msg = DiscoverSkillsTool.renderToolUseMessage({
+      description: 'deploy to cloudflare',
+    })
+    expect(msg).toContain('deploy to cloudflare')
+  })
+
+  test('mapToolResultToToolResultBlockParam formats empty results', async () => {
+    const { DiscoverSkillsTool } = await import('../DiscoverSkillsTool.js')
+    const result = DiscoverSkillsTool.mapToolResultToToolResultBlockParam(
+      { results: [], count: 0 },
+      'test-id',
+    )
+    expect(result.content).toContain('No matching skills')
+  })
+
+  test('mapToolResultToToolResultBlockParam formats results', async () => {
+    const { DiscoverSkillsTool } = await import('../DiscoverSkillsTool.js')
+    const result = DiscoverSkillsTool.mapToolResultToToolResultBlockParam(
+      {
+        results: [{ name: 'test-skill', description: 'A test skill', score: 0.85 }],
+        count: 1,
+      },
+      'test-id',
+    )
+    expect(result.content).toContain('test-skill')
+    expect(result.content).toContain('0.85')
+  })
+})

packages/builtin-tools/src/tools/DiscoverSkillsTool/__tests__/DiscoverSkillsTool.test.ts

@@ -1,3 +1,13 @@
-// Auto-generated stub — replace with real implementation
-export {};
-export const DISCOVER_SKILLS_TOOL_NAME: string = '';
+export const DISCOVER_SKILLS_TOOL_NAME = 'DiscoverSkills'
+
+export const DESCRIPTION =
+  'Search for relevant skills by describing what you want to do'
+
+export const DISCOVER_SKILLS_PROMPT = `Search for skills relevant to a task description. Returns matching skills ranked by relevance.
+
+Use this when:
+- The auto-surfaced skills don't cover your current task
+- You're pivoting to a different kind of work mid-conversation
+- You want to find specialized skills for an unusual workflow
+
+The search uses TF-IDF keyword matching against all registered skills (bundled, user-defined, and MCP-provided). Results include skill name, description, and relevance score.`

packages/builtin-tools/src/tools/DiscoverSkillsTool/prompt.ts

@@ -0,0 +1,152 @@
+import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { call } from '../skill-learning.js'
+import {
+  recordSkillGap,
+  saveInstinct,
+  createInstinct,
+  resolveProjectContext,
+} from '../../../services/skillLearning/index.js'
+
+let root: string
+const originalEnv = { ...process.env }
+
+beforeEach(() => {
+  root = mkdtempSync(join(tmpdir(), 'skill-learning-command-'))
+  process.env = { ...originalEnv }
+  process.env.CLAUDE_SKILL_LEARNING_HOME = root
+  process.env.CLAUDE_CONFIG_DIR = join(root, 'config')
+  process.env.SKILL_LEARNING_ENABLED = '1'
+})
+
+afterEach(() => {
+  process.env = { ...originalEnv }
+  rmSync(root, { recursive: true, force: true })
+})
+
+describe('skill-learning command', () => {
+  test('status reports observations and instincts', async () => {
+    const result = await call('status', {} as any)
+
+    expect(result.type).toBe('text')
+    if (result.type === 'text') {
+      expect(result.value).toContain('Skill Learning status')
+      expect(result.value).toContain('Observations: 0')
+    }
+  })
+
+  test('promote (no args) prints usage and candidate summary', async () => {
+    const result = await call('promote', {} as any)
+
+    expect(result.type).toBe('text')
+    if (result.type === 'text') {
+      expect(result.value).toContain('Promotion candidates')
+      expect(result.value).toContain('promote gap')
+      expect(result.value).toContain('promote instinct')
+    }
+  })
+
+  test('promote gap <key> promotes a pending gap to draft', async () => {
+    const project = resolveProjectContext(process.cwd())
+    const gap = await recordSkillGap({
+      prompt: 'refactor the api gateway',
+      cwd: process.cwd(),
+      project,
+      rootDir: root,
+    })
+    expect(gap.status).toBe('pending')
+
+    const result = await call(`promote gap ${gap.key}`, {} as any)
+
+    expect(result.type).toBe('text')
+    if (result.type === 'text') {
+      expect(result.value).toContain('Promoted gap')
+      expect(result.value).toContain('status=draft')
+    }
+  })
+
+  test('promote gap <unknown-key> reports not found', async () => {
+    const result = await call('promote gap does-not-exist', {} as any)
+    expect(result.type).toBe('text')
+    if (result.type === 'text') {
+      expect(result.value).toContain('No gap found')
+    }
+  })
+
+  test('promote instinct <id> copies a project instinct to global scope', async () => {
+    const project = resolveProjectContext(process.cwd())
+    const instinct = createInstinct({
+      trigger: 'when committing',
+      action: 'run tests first',
+      confidence: 0.85,
+      domain: 'testing',
+      source: 'session-observation',
+      scope: 'project',
+      projectId: project.projectId,
+      projectName: project.projectName,
+      evidence: ['observed twice'],
+    })
+    await saveInstinct(instinct, { project, rootDir: root })
+
+    const result = await call(`promote instinct ${instinct.id}`, {} as any)
+
+    expect(result.type).toBe('text')
+    if (result.type === 'text') {
+      expect(result.value).toContain('Promoted instinct')
+      expect(result.value).toContain('global scope')
+    }
+  })
+
+  test('projects lists known project scopes', async () => {
+    // Resolving once registers the current project in the registry.
+    resolveProjectContext(root)
+
+    const result = await call('projects', {} as any)
+
+    expect(result.type).toBe('text')
+    if (result.type === 'text') {
+      expect(
+        result.value.includes('Known project scopes') ||
+          result.value.includes('No known project scopes'),
+      ).toBe(true)
+    }
+  })
+
+  test('default help mentions promote and projects, no write-fixture', async () => {
+    const result = await call('unknown-sub', {} as any)
+    expect(result.type).toBe('text')
+    if (result.type === 'text') {
+      expect(result.value).toContain('promote')
+      expect(result.value).toContain('projects')
+      expect(result.value).not.toContain('write-fixture')
+    }
+  })
+
+  test('ingest imports transcript observations and instincts', async () => {
+    const transcript = join(root, 'session.jsonl')
+    writeFileSync(
+      transcript,
+      JSON.stringify({
+        type: 'user',
+        sessionId: 's1',
+        cwd: root,
+        message: { role: 'user', content: '不要 mock，用 testing-library' },
+      }) + '\n',
+    )
+
+    // Pass --min-session-length=0 so the 1-line test transcript is not skipped
+    // by the ECC-parity gate (default threshold: 10 observations).
+    const result = await call(
+      `ingest ${transcript} --min-session-length=0`,
+      {} as any,
+    )
+
+    expect(result.type).toBe('text')
+    if (result.type === 'text') {
+      expect(result.value).toContain('Ingested')
+      expect(result.value).toContain('saved 1 instincts')
+    }
+  })
+})

src/commands/skill-learning/__tests__/skill-learning.test.ts

@@ -0,0 +1,15 @@
+import type { Command } from '../../commands.js'
+import { isSkillLearningEnabled } from '../../services/skillLearning/featureCheck.js'
+
+const skillLearning = {
+  type: 'local-jsx',
+  name: 'skill-learning',
+  description: 'Manage skill learning (observe, analyze, evolve)',
+  argumentHint:
+    '[start|stop|about|status|ingest|evolve|export|import|prune|promote|projects]',
+  isEnabled: () => isSkillLearningEnabled(),
+  isHidden: false,
+  load: () => import('./skillPanel.js'),
+} satisfies Command
+
+export default skillLearning