AutoSkill：自动技能提炼系统设计文档

会话启动
  toolCallCount = 0

每次工具调用完成
  toolCallCount += 1

会话结束
  if (toolCallCount >= AUTO_SKILL_THRESHOLD):  // 默认 20
    检查 skillsModifiedInSession
    ├─ true  → skip（本轮已手动操作 skill，无需自动 review）
    └─ false → scheduleSkillReview()

每次工具调用完成
  if (工具调用的目标路径在 ${projectRoot}/.qwen/skills/ 下):
    skillsModifiedInSession = true

会话结束
  ├─ scheduleExtract(params)           // 现有逻辑不变
  └─ scheduleSkillReview(params)       // 新增
       条件：toolCallCount >= AUTO_SKILL_THRESHOLD
             && !skillsModifiedInSession

skill_review_agent: edit is only allowed on skills with 'source: auto-skill' in frontmatter.
This skill appears to be user-created. Modify it manually or ask the user.

// skill review agent 允许的操作
read_file:    无路径限制（需要读取任意文件来了解项目上下文）
ls:           无路径限制
shell:        只读命令（Shell AST 静态分析，复用现有 isShellCommandReadOnlyAST）
write_file:   仅限 ${projectRoot}/.qwen/skills/ 路径下的文件（创建新 skill）
edit:         仅限 ${projectRoot}/.qwen/skills/ 内，且目标文件含 source: auto-skill

Review the conversation above and consider saving or updating a skill if appropriate.

Focus on: was a non-trivial approach used to complete a task that required trial
and error, or changing course due to experiential findings along the way, or did
the user expect or desire a different method or outcome? If a relevant skill
already exists and has 'source: auto-skill' in its frontmatter, update it with
what you learned. Otherwise, create a new skill if the approach is reusable.

IMPORTANT constraints:
- You may ONLY modify skill files that contain 'source: auto-skill' in their
  YAML frontmatter. Always read a skill file before editing it.
- Do NOT touch skills that lack this marker — they were created by the user.
- When creating a new skill, you MUST include 'source: auto-skill' in the
  frontmatter so future review agents can safely update it.
- Do NOT delete any skill. Only create or update.

If nothing is worth saving, just say 'Nothing to save.' and stop.

Skills are saved to the current project (.qwen/skills/).
Use write_file to create a new skill, edit to update an existing auto-skill.
Each skill lives at .qwen/skills/<name>/SKILL.md with YAML frontmatter:

---
name: <skill-name>
description: <one-line description>
metadata:
  source: auto-skill
  extracted_at: '<ISO-8601 timestamp>'
---

<markdown body with the procedure/approach>

{
  name: "managed-skill-extractor",
  tools: [
    "read_file",   // 读现有 skill 内容，检查 source: auto-skill
    "ls",          // 扫描 .qwen/skills/ 目录
    "write_file",  // 创建新 skill 文件（权限管理器限制路径）
    "edit",        // 修改已有 auto-skill（权限管理器验证 frontmatter）
    "shell",       // 只读命令（如 find、cat）
  ],
  permissionManager: createSkillScopedAgentConfig(config, projectRoot),
  history: sessionHistory,  // 传入完整对话历史快照
}

export interface ScheduleSkillReviewParams {
  projectRoot: string;
  sessionId: string;
  history: Content[]; // 完整会话历史快照
  toolCallCount: number; // 本次会话的工具调用次数
  skillsModified: boolean; // 本次会话是否有写操作落在 .qwen/skills/
  config?: Config;
  enabled?: boolean;
  threshold?: number;
  maxTurns?: number;
  timeoutMs?: number;
}
 
export interface SkillReviewScheduleResult {
  status: 'scheduled' | 'skipped';
  taskId?: string;
  skippedReason?: 'below_threshold' | 'skills_modified_in_session' | 'disabled';
}

scheduleSkillReview(params: ScheduleSkillReviewParams): SkillReviewScheduleResult {
  // 1. 配置门控
  if (params.enabled === false) {
    return { status: 'skipped', skippedReason: 'disabled' };
  }
 
  // 2. 阈值检查
  const threshold = params.threshold ?? AUTO_SKILL_THRESHOLD;
  if (params.toolCallCount < threshold) {
    return { status: 'skipped', skippedReason: 'below_threshold' };
  }
 
  // 3. 本轮已主动操作 skill，跳过自动 review
  if (params.skillsModified) {
    return { status: 'skipped', skippedReason: 'skills_modified_in_session' };
  }
 
  // 4. 独立调度
  const record = makeTaskRecord('skill-review', params.projectRoot, params.sessionId);
  const promise = this.track(record.id, this.runSkillReview(record, params));
  return { status: 'scheduled', taskId: record.id, promise };
}

// 扩展现有 MemoryTaskRecord.taskType
export type MemoryTaskType = 'extract' | 'dream' | 'skill-review';
 
// 常量
export const AUTO_SKILL_THRESHOLD = 20; // 工具调用次数阈值

会话进行中
  agent 主循环
    ├─ 每次工具调用 → toolCallCount += 1
    └─ 若写操作目标路径在 ${projectRoot}/.qwen/skills/ 下
         → skillsModifiedInSession = true

会话结束（sessionEnd 事件）
  ├─ scheduleExtract(params)
  │     └─ [现有逻辑：fork extraction agent → 写 .qwen/memory/]
  │
  └─ toolCallCount >= 20 && !skillsModifiedInSession ?
       ├─ 否 → skip（密度不足 或 本轮已手动操作 skill）
       └─ 是 → scheduleSkillReview(params)
                 └─ 独立 fork skill review agent
                        ↓
                 skill review agent（max 8 轮，2 min，沙箱权限）
                 工具：read_file, ls, write_file, edit, shell
                 传入完整 sessionHistory
                        ↓
                 模型判断是否有可复用方法
                 ├─ 有 → 读取已有 skill（检查 source: auto-skill）
                 │         → write_file 创建新 skill（含 source: auto-skill）
                 │         → edit 更新已有 auto-skill
                 │         → SkillManager 缓存失效（notifyChangeListeners）
                 └─ 无 → "Nothing to save." 结束

下次会话
  SkillManager.listSkills({ level: 'project' })
  → 扫描 .qwen/skills/ 发现新建 skill
  → 注入 system prompt 的 <available_skills> 块（Tier 1）

---
name: <skill-name> # 必填，小写字母 + 连字符
description: <description> # 必填，≤ 1024 字符
version: 1.0.0
metadata:
  source: auto-skill # 必填（review agent 创建时强制写入）
  extracted_at: '2026-04-24T12:00:00Z'
---
# <技能标题>
 
<操作步骤 / 最佳实践 / 注意事项>

// config schema 新增（在 memory 下）
memory?: {
  enableAutoSkill?: boolean;   // 默认 true
}

{
  "memory": {
    "enableAutoSkill": true
  }
}

现有 MemoryManager
  ├─ scheduleExtract()       ← 不变
  ├─ scheduleDream()         ← 不变
  ├─ recall()                ← 不变
  ├─ forget()                ← 不变
  └─ scheduleSkillReview()   ← 新增（本文档）

现有 SkillManager
  ├─ listSkills()            ← 不变（自动发现 .qwen/skills/ 下新增文件）
  └─ loadSkill()             ← 不变

现有文件工具（read_file / write_file / edit）
  ├─ 主会话中：用户可通过这些工具手动管理 skill
  │   └─ 写操作落在 .qwen/skills/ → skillsModifiedInSession = true
  └─ skill review agent 中：直接用于创建/更新 auto-skill
      └─ 权限管理器限制路径 + 验证 source: auto-skill

触发点（现有 sessionEnd hook）
  └─ 同时调用 scheduleExtract + scheduleSkillReview（条件满足时）