mocode-ai 1.2.8 → 1.2.9

package/dist/plan/store.js

@@ -1,429 +0,0 @@
-// 单 plan 的文件级存储:CRUD + markdown 解析/序列化。
-//
-// 设计目标
-//  - 文件是唯一事实源(抗压缩、可视化、用户可改)。每次写都 atomic(rename 覆盖)。
-//  - 同会话单 plan(state.ts 跟踪「活跃」,本模块不参与并发控制——单进程单活跃 plan 串行调用)。
-//  - 解析宽松:坏 frontmatter / 缺段 → 退化到最小可用 Plan,不抛。
-//  - 序列化稳定:每段顺序固定(frontmatter → 目标 → 步骤 → 进度日志),便于 git diff 友好。
-//
-// 不依赖 agent / ui / llm;仅 node:fs + node:path。仿 memory/store.ts 的「叶子」分层。
-import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { getSandboxRoot } from '../sandbox/root.js';
-// ── 路径 ──
-/** plans 目录:<sandboxRoot>/.mocode/plans/。无 sandboxRoot 退到 cwd(防御)。 */
-export function plansDir() {
-    const root = getSandboxRoot() ?? process.cwd();
-    return join(root, '.mocode', 'plans');
-}
-/** 归档目录:<root>/.mocode/plans/archive/。finish 自动归档、用户手动 unarchive 都走这里。 */
-export function archiveDir() {
-    return join(plansDir(), 'archive');
-}
-/** 单 plan 文件路径:<root>/.mocode/plans/<id>.md。可选 baseDir:默认 plans,也可指 archive。 */
-export function planPath(id, baseDir = plansDir()) {
-    return join(baseDir, `${id}.md`);
-}
-/** 确保 plans 目录存在(惰性,工具每次写前调)。 */
-export function ensurePlansDir() {
-    const d = plansDir();
-    if (!existsSync(d))
-        mkdirSync(d, { recursive: true });
-}
-/** 确保归档目录存在(惰性)。 */
-export function ensureArchiveDir() {
-    const d = archiveDir();
-    if (!existsSync(d))
-        mkdirSync(d, { recursive: true });
-}
-// ── ID 生成 ──
-/** 本地时间戳(无时区后缀),与 filename 的 YYYY-MM-DDTHH-mm-ss 风格一致。
- *  例:2026-07-04T22:54:51.729(本地时,便于人对读 frontmatter / progress log,
- *  且与同 plan id 文件名"2026-07-04T22-54-51"对应)。
- *  不带 Z 后缀 → JS Date 解析会按本地时读(一致 round-trip);
- *  反例:toISOString() 返 2026-07-04T14:54:51.729Z(UTC),跟用户当地差 8 小时,易误解。 */
-export function localIsoTimestamp(d = new Date()) {
-    const pad = (n) => String(n).padStart(2, '0');
-    const padMs = (n) => String(n).padStart(3, '0');
-    return (`${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}` +
-        `T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${padMs(d.getMilliseconds())}`);
-}
-/** plan id:YYYY-MM-DDTHH-mm-ss-xxxxxx(本地时间,文件名安全)。xxxxxx = 4 字节随机 hex(防同秒并发撞)。 */
-export function newPlanId(now = new Date()) {
-    const pad = (n) => String(n).padStart(2, '0');
-    const y = now.getFullYear();
-    const mo = pad(now.getMonth() + 1);
-    const d = pad(now.getDate());
-    const h = pad(now.getHours());
-    const mi = pad(now.getMinutes());
-    const s = pad(now.getSeconds());
-    // crypto 不必要;Math.random 够防同秒撞(碰撞概率 ~1/2^32)
-    const r = Math.floor(Math.random() * 0xffffffff).toString(16).padStart(8, '0');
-    return `${y}-${mo}-${d}T${h}-${mi}-${s}-${r}`;
-}
-// ── 解析(宽松,坏文件不抛,退化到最小可用 Plan)──
-const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
-const CHECKBOX_RE = /^(\s*)-\s+\[([ xX\/~])\]\s+(\d+)\.\s+(.+?)\s*$/;
-const LOG_RE = /^-\s+(\S+)\s+(.+?)\s*$/;
-/**
- * 解析 plan 文件为 Plan 对象。失败(无 frontmatter / 段缺失 / 坏 checkbox)→ 退化:
- *  - 无 frontmatter:把整文当 title 段
- *  - 缺字段:空串 / 空数组
- *  - 坏 checkbox:跳过该行,不污染好行
- * 解析成功但 step id 缺序 / 重号:按出现顺序重排为 1..N(保稳定)。
- */
-export function parsePlan(raw, fallbackId) {
-    const now = localIsoTimestamp();
-    let meta = {};
-    let body = raw;
-    const m = FRONTMATTER_RE.exec(raw);
-    if (m) {
-        meta = parseFrontmatter(m[1]);
-        body = m[2];
-    }
-    const id = meta.id || fallbackId;
-    const title = meta.title || extractFirstHeading(body) || '(无标题)';
-    const status = normalizePlanStatus(meta.status);
-    const created = meta.created || now;
-    const updated = meta.updated || now;
-    const { goal, steps, log } = parseBody(body);
-    // 步骤 id 规范化:1..N(防文件手改致 id 跳号)
-    const normSteps = steps.map((s, i) => ({ ...s, id: i + 1 }));
-    return { id, title, status, created, updated, goal, steps: normSteps, log };
-}
-function parseFrontmatter(s) {
-    const out = {};
-    for (const line of s.split('\n')) {
-        const idx = line.indexOf(':');
-        if (idx <= 0)
-            continue;
-        const k = line.slice(0, idx).trim();
-        const v = line.slice(idx + 1).trim();
-        if (k)
-            out[k] = v;
-    }
-    return out;
-}
-function normalizePlanStatus(s) {
-    if (s === 'finished' || s === 'abandoned')
-        return s;
-    return 'in_progress';
-}
-function extractFirstHeading(body) {
-    const m = /^#\s+(.+?)\s*$/m.exec(body);
-    return m ? m[1] : '';
-}
-function parseBody(body) {
-    const sections = {};
-    const re = /^##\s+(.+?)\s*$/gm;
-    let lastKey = '';
-    let lastStart = -1;
-    let m;
-    while ((m = re.exec(body)) !== null) {
-        if (lastKey)
-            sections[lastKey] = body.slice(lastStart, m.index);
-        lastKey = m[1].trim();
-        lastStart = m.index + m[0].length;
-    }
-    if (lastKey)
-        sections[lastKey] = body.slice(lastStart);
-    const goal = (sections['目标'] || sections['Goal'] || '').trim();
-    const stepBlock = sections['步骤'] || sections['Steps'] || '';
-    const logBlock = sections['进度日志'] || sections['Log'] || sections['进度'] || '';
-    const steps = [];
-    for (const line of stepBlock.split('\n')) {
-        const cm = CHECKBOX_RE.exec(line);
-        if (!cm)
-            continue;
-        const marker = cm[2].toLowerCase();
-        const status = marker === 'x' ? 'done' :
-            marker === '/' ? 'in_progress' :
-                marker === '~' ? 'skipped' :
-                    'pending';
-        const id = Number(cm[3]);
-        const title = cm[4].trim();
-        if (!Number.isFinite(id) || id < 1)
-            continue;
-        steps.push({ id, title, status });
-    }
-    const log = [];
-    for (const line of logBlock.split('\n')) {
-        const lm = LOG_RE.exec(line);
-        if (!lm)
-            continue;
-        log.push({ at: lm[1], text: lm[2] });
-    }
-    return { goal, steps, log };
-}
-// ── 序列化 ──
-/** 序列化为 markdown 文本。固定段序:frontmatter → 目标 → 步骤 → 进度日志。 */
-export function serializePlan(p) {
-    const lines = [];
-    lines.push('---');
-    lines.push(`id: ${p.id}`);
-    lines.push(`title: ${p.title}`);
-    lines.push(`status: ${p.status}`);
-    lines.push(`created: ${p.created}`);
-    lines.push(`updated: ${p.updated}`);
-    lines.push('---');
-    lines.push('');
-    lines.push(`# ${p.title}`);
-    lines.push('');
-    lines.push('## 目标');
-    lines.push(p.goal || '(未填写)');
-    lines.push('');
-    lines.push('## 步骤');
-    if (p.steps.length === 0) {
-        lines.push('(无步骤)');
-    }
-    else {
-        for (const s of p.steps) {
-            lines.push(`- [${checkboxMarker(s.status)}] ${s.id}. ${s.title}`);
-        }
-    }
-    lines.push('');
-    lines.push('## 进度日志');
-    if (p.log.length === 0) {
-        lines.push('(无)');
-    }
-    else {
-        for (const e of p.log) {
-            lines.push(`- ${e.at} ${e.text}`);
-        }
-    }
-    lines.push('');
-    return lines.join('\n');
-}
-function checkboxMarker(s) {
-    switch (s) {
-        case 'done': return 'x';
-        case 'in_progress': return '/';
-        case 'skipped': return '~';
-        case 'failed': return 'x'; // 用 x + log 标 failed(checkbox 集 [ ]/x/[x] 之外的细态不上,降级)
-        case 'pending':
-        default: return ' ';
-    }
-}
-// ── CRUD(直接落盘)──
-/** 读 plan 文件;不存在 → null,坏文件 → fallbackId 最小可用 Plan(不抛,工具契约)。
- *  可选 baseDir:默认 plans,传 archiveDir() 可读归档。 */
-export function readPlan(id, baseDir = plansDir()) {
-    const p = planPath(id, baseDir);
-    if (!existsSync(p))
-        return null;
-    try {
-        return parsePlan(readFileSync(p, 'utf8'), id);
-    }
-    catch {
-        return null;
-    }
-}
-/** 写 plan 文件(atomic:写 .tmp 再 rename)。返回是否成功。 */
-export function writePlan(p) {
-    try {
-        ensurePlansDir();
-        const target = planPath(p.id);
-        const tmp = target + '.tmp';
-        writeFileSync(tmp, serializePlan(p), 'utf8');
-        renameSync(tmp, target);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/** 删 plan 文件;不存在静默 ok。可选 baseDir:默认 plans,传 archiveDir() 删归档。 */
-export function deletePlan(id, baseDir = plansDir()) {
-    const p = planPath(id, baseDir);
-    if (!existsSync(p))
-        return true;
-    try {
-        unlinkSync(p);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * 原子读-改-写:读 → mutator 改 → 写。mutator 返回 false 视为"无改动",跳过写。
- * mutator 抛错 → 写失败 → 返 null(不抛,工具契约)。
- *
- * mutator 同步:本 store 走同步 fs,mutator 必须同步(返 Promise 视为"无信号"——返原对象);
- *  设计如此以避免把 fs API 改成 async(同步 fs 在 node 单 tick 原子,无需锁)。
- */
-export function updatePlan(id, mutator) {
-    const cur = readPlan(id);
-    if (!cur)
-        return null;
-    let next;
-    try {
-        next = mutator(cur);
-    }
-    catch {
-        return null;
-    }
-    if (next === false)
-        return cur; // 无改动:返原对象
-    next.updated = localIsoTimestamp();
-    if (!writePlan(next))
-        return null;
-    return next;
-}
-/** 列 plans 目录下所有 plan(按 updated 倒序,最新在前)。解析失败的跳过。
- *  scope: 'active'(默认)=仅 plans/;'archived'=仅 archive/;'all'=合并(去重按 id)。 */
-export function listPlans(scope = 'active') {
-    const dirs = [];
-    if (scope === 'active')
-        dirs.push(plansDir());
-    else if (scope === 'archived')
-        dirs.push(archiveDir());
-    else {
-        dirs.push(plansDir());
-        dirs.push(archiveDir());
-    }
-    const out = [];
-    const seen = new Set();
-    for (const dir of dirs) {
-        if (!existsSync(dir))
-            continue;
-        let names;
-        try {
-            names = readdirSync(dir).filter((n) => n.endsWith('.md'));
-        }
-        catch {
-            continue;
-        }
-        for (const n of names) {
-            const id = n.slice(0, -3);
-            if (seen.has(id))
-                continue;
-            seen.add(id);
-            const p = readPlan(id, dir);
-            if (p)
-                out.push(p);
-        }
-    }
-    out.sort((a, b) => (a.updated < b.updated ? 1 : a.updated > b.updated ? -1 : 0));
-    return out;
-}
-// ── 归档/还原/全删 ──
-/** 把 plans/<id>.md mv 到 plans/archive/<id>.md(atomic rename)。
- *  源不存在 → false(已归档 / 删了 / 从未存在都算)。 */
-export function archivePlan(id) {
-    const src = planPath(id, plansDir());
-    if (!existsSync(src))
-        return false;
-    ensureArchiveDir();
-    const dst = planPath(id, archiveDir());
-    try {
-        renameSync(src, dst);
-    }
-    catch {
-        return false;
-    }
-    return true;
-}
-/** 把 plans/archive/<id>.md 还原到 plans/<id>.md。源不存在 → false。 */
-export function unarchivePlan(id) {
-    const src = planPath(id, archiveDir());
-    if (!existsSync(src))
-        return false;
-    ensurePlansDir();
-    const dst = planPath(id, plansDir());
-    try {
-        renameSync(src, dst);
-    }
-    catch {
-        return false;
-    }
-    return true;
-}
-/** 任一处存在就都删(活跃 + 归档)。用于 todolist delete 不关心来源。 */
-export function deletePlanAnywhere(id) {
-    let any = false;
-    if (existsSync(planPath(id, plansDir())))
-        any = deletePlan(id, plansDir()) || any;
-    if (existsSync(planPath(id, archiveDir())))
-        any = deletePlan(id, archiveDir()) || any;
-    return any;
-}
-// ── 渲染(给 LLM / UI 用)──
-/** 把 Plan 渲成给 LLM 看的紧凑摘要(多行文本)。 */
-export function renderPlanForLLM(p) {
-    const lines = [];
-    lines.push(`# ${p.title} [${p.status}]`);
-    if (p.goal)
-        lines.push(`\n## 目标\n${p.goal}`);
-    const done = p.steps.filter((s) => s.status === 'done' || s.status === 'skipped').length;
-    lines.push(`\n## 步骤 (${done}/${p.steps.length} 完成)`);
-    if (p.steps.length === 0) {
-        lines.push('(无)');
-    }
-    else {
-        for (const s of p.steps) {
-            lines.push(`- [${checkboxMarker(s.status)}] ${s.id}. ${s.title}`);
-        }
-    }
-    if (p.log.length > 0) {
-        lines.push(`\n## 进度日志(最近 ${Math.min(p.log.length, 5)} 条)`);
-        for (const e of p.log.slice(-5))
-            lines.push(`- ${e.at} ${e.text}`);
-    }
-    return lines.join('\n');
-}
-/**
- * 状态行 chip 的短摘要:`plan: 标题 (done/total) ▸ <当前 in_progress 步骤>`。
- * 无活跃 plan → 空串。
- *
- * 字符截断(非终端宽,固定长度 ~50 字符,方便状态行收纳):
- *  - 标题(plan 标题):超 10 字截断,加 "..."
- *  - 步骤标题:超 17 字截断,加 "..."
- *  - 例:`plan: 3D 贪吃蛇游戏 (0/9) ▸ 1. 搭建项目骨架:创建 snake3d...`
- *
- * 当前步骤取 status=in_progress;无 in_progress 但有 pending 时回退到第一项 pending
- * (LLM 刚标记某步 done 还没动 next 时,这样能看清下一步)。
- * 全 done → 不带 tail;finished → 拼「✓ N/N」。
- *
- * maxWidth 是软上限:极端窄(<26)时只保 head+count 不带 tail;否则按上述字符限。
- */
-const PLAN_TITLE_MAX = 10;
-const STEP_TITLE_MAX = 17;
-const TRUNC_DOTS = '...';
-export function renderPlanChip(p, maxWidth = 56) {
-    if (!p)
-        return '';
-    const title = truncateByChars(p.title, PLAN_TITLE_MAX);
-    const head = p.status === 'finished'
-        ? `plan ✓ ${title}`
-        : `plan: ${title}`;
-    const total = p.steps.length;
-    const done = p.steps.filter((s) => s.status === 'done' || s.status === 'skipped').length;
-    const count = `(${done}/${total})`;
-    const fixed = `${head} ${count}`;
-    // 极窄:没空间塞步骤,只保 head+count
-    if (maxWidth < 26)
-        return fixed;
-    const cur = p.status === 'in_progress'
-        ? p.steps.find((s) => s.status === 'in_progress')
-            ?? p.steps.find((s) => s.status === 'pending')
-        : null; // finished / abandoned → 不显当前步
-    if (!cur)
-        return fixed;
-    const stepTitle = truncateByChars(cur.title, STEP_TITLE_MAX);
-    return `${fixed} ▸ ${cur.id}. ${stepTitle}`;
-}
-/** 字符数截断(非显示宽):超 max 字符截到 max + "..."(3 字符省略号固定)。
- *  <= max → 原样返回;> max → 前 max 字符 + "..."。 */
-function truncateByChars(s, max) {
-    if (s.length <= max)
-        return s;
-    return s.slice(0, max) + TRUNC_DOTS;
-}
-function truncateForChip(s, max = 18) {
-    if (s.length <= max)
-        return s;
-    if (max <= 1)
-        return '…';
-    return s.slice(0, max - 1) + '…';
-}

package/dist/project-skill/index.js

@@ -1,95 +0,0 @@
-/**
- * 项目专属 Skill — 跨 session 持久化的项目开发知识。
- *
- * 每个项目可维护一个专属 skill 文件(.mocode/project-skill.md)，
- * 记录开发约定、架构决策、常见坑点等。开关启用后:
- *   1. 每次启动时内容注入系统提示词(buildProjectSkillSection)
- *   2. Agent 可通过 project_skill_update 工具动态更新
- *   3. 随着项目开发，skill 越来越了解项目，开发效率越来越高
- *
- * 存储位置: <cwd>/.mocode/project-skill.md
- * 开关: MOCODE_PROJECT_SKILL 环境变量，默认 false(零侵入)
- *
- * 与现有功能的关系:
- *   - 通用 skill(SKILLS_DIRS): 按需加载(use_skill);项目 skill: 始终注入
- *   - memory: 碎片化 fact/decision; 项目 skill: 结构化知识总结
- *   - snapshot: 静态文件缓存(只读); 项目 skill: 动态知识(可写)
- */
-import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync } from 'node:fs';
-import path from 'node:path';
-/** 项目 skill 文件路径 */
-function skillPath() {
-    return path.join(process.cwd(), '.mocode', 'project-skill.md');
-}
-/** 备份文件路径 */
-function backupPath() {
-    return path.join(process.cwd(), '.mocode', 'project-skill.md.bak');
-}
-/** 读取项目 skill 内容。不存在/读失败 → null */
-export function readProjectSkill() {
-    const p = skillPath();
-    if (!existsSync(p))
-        return null;
-    try {
-        const content = readFileSync(p, 'utf8').trim();
-        return content || null;
-    }
-    catch {
-        return null;
-    }
-}
-/** 写入/更新项目 skill。内容不设字符上限；写入前备份旧内容。 */
-export function writeProjectSkill(content) {
-    const trimmed = content.trim();
-    const p = skillPath();
-    const dir = path.dirname(p);
-    try {
-        if (existsSync(p)) {
-            copyFileSync(p, backupPath());
-        }
-        mkdirSync(dir, { recursive: true });
-        writeFileSync(p, trimmed + '\n', 'utf8');
-        return { ok: true };
-    }
-    catch (e) {
-        return { ok: false, error: `写入失败: ${e.message}` };
-    }
-}
-/** 追加内容到项目 skill 末尾(以 \n\n 分隔)，内容不设字符上限。 */
-export function appendProjectSkill(addition) {
-    const existing = readProjectSkill() ?? '';
-    const trimmed = addition.trim();
-    if (!trimmed)
-        return { ok: false, error: '追加内容为空' };
-    const separator = existing ? '\n\n' : '';
-    return writeProjectSkill(existing + separator + trimmed);
-}
-/** 兼容旧调用名：字数限制取消后直接写入，不再调用 LLM 压缩。 */
-export async function writeProjectSkillWithCompression(content, _maxAttempts = 3, _signal) {
-    return { ...writeProjectSkill(content), compressed: false };
-}
-/** 兼容旧调用名：字数限制取消后直接追加，不再调用 LLM 压缩。 */
-export async function appendProjectSkillWithCompression(addition, _maxAttempts = 3, _signal) {
-    return { ...appendProjectSkill(addition), compressed: false };
-}
-/**
- * 生成系统提示词注入段。
- * 开关关闭或文件不存在 → 空串(零行为变化)。
- *
- * 精简版：只注入 skill 内容本身，维护指南移到 project_skill_update 工具描述中。
- */
-export function buildProjectSkillSection() {
-    const content = readProjectSkill();
-    if (!content)
-        return '';
-    return [
-        '',
-        '',
-        '## Project Skill (project-specific knowledge)',
-        'The following is project-specific knowledge maintained across sessions. Use it as context for all tasks in this project.',
-        '',
-        '<project-skill>',
-        content,
-        '</project-skill>',
-    ].join('\n');
-}

package/dist/project-skill/initializer.js

@@ -1,178 +0,0 @@
-/**
- * 项目 Skill 初始化器 - 派生子 agent 带工具深度探索项目，生成高质量的初始 skill
- */
-import { spawnAgent } from '../agent/spawn.js';
-/**
- * 子 agent 的系统提示后缀：角色与输出格式约束
- */
-const SKILL_INIT_SUFFIX = `You are a project exploration agent. Your task is to deeply understand this project and generate a concise "Project Skill" document.
-
-## ⚠️ Complementary to Snapshot — CRITICAL
-The following information is ALREADY provided by Project Snapshot — **do NOT repeat**:
-- ✗ Project one-liner description (快照已有)
-- ✗ Module names and file locations (快照 srcTree 已有)
-- ✗ Tech stack names and versions (快照 techStack 已有)
-- ✗ Build/test commands (快照 keyCommands 已有)
-- ✗ File lists and directory structure (快照 srcTree 已有)
-
-**Your job is to capture INSIGHTS only:**
-- **WHY** — design decisions, trade-offs, reasons for choosing X over Y
-- **HOW** — module behaviors, data flows, call chains, non-obvious interactions
-- **GOTCHAS** — pitfalls, edge cases, non-intuitive behaviors
-- **CONVENTIONS** — naming patterns, code style, unwritten rules
-
-## Exploration Strategy
-1. Use \`codegraph\` to trace call chains and understand module interactions
-2. Read core modules to understand **behaviors** (not just names)
-3. Look for complex logic, error handling patterns, unusual configs
-4. Identify naming conventions, common abstractions
-
-## Output Format
-Output the skill document between these exact delimiters:
-
-\`\`\`skill-start
-## 架构要点
-### 核心模块及职责
-- **\`path/to/module\`** — 行为描述（做什么 + 怎么做）
-...
-
-### 关键设计决策
-- 决策：原因
-...
-
-## 项目约定
-- 约定（具体的，有例子的）
-...
-
-## 开发流程
-- 命令 + 注意事项/坑点（命令本身快照已有，这里只写注意什么）
-...
-
-## 常见坑点
-- 坑：解法
-...
-\`\`\`skill-end
-
-## Rules — MUST FOLLOW
-1. 禁止列出文件名清单或目录结构
-2. 禁止列出依赖名和版本
-3. 禁止写项目概述/一句话描述
-4. 禁止只写命令本身（快照已有），只写注意事项
-5. 每个模块描述必须包含行为（做什么 + 怎么协作），不只是名称
-6. **总长度目标 3000-4000 字符，硬上限 4000**
-7. 写可操作的内容，用具体路径和例子
-8. 如果某个 section 没有实质内容，省略它
-`;
-/**
- * 生成初始项目 Skill（使用子 agent 深度探索）
- * @param existingSkill 已有的 skill 内容（如果有，子 agent 会在其基础上优化）
- * @param signal AbortSignal
- */
-export async function generateInitialSkill(existingSkill, signal) {
-    const hasExisting = !!existingSkill;
-    let prompt;
-    if (hasExisting) {
-        prompt = `以下是当前的项目 Skill 内容，请深度探索项目并优化/完善它：
-
-\`\`\`markdown
-${existingSkill}
-\`\`\`
-
-## 优化方向
-1. 补充缺失的信息（架构要点、设计决策、调用链等）
-2. 修正过时或不准确的内容
-3. 让描述更具体（用实际路径和例子）
-4. 删除冗余或空泛的描述
-5. 如果发现新的坑点或约定，添加进去
-
-记住：保持精简，总长度控制在 4000-5000 字符。输出完整的优化后版本。`;
-    }
-    else {
-        prompt = `请深度探索当前项目，生成一份项目专属 Skill 文档。
-
-## 探索步骤
-1. 先用 glob 扫描项目结构（**/*.ts, **/*.json 等）
-2. 读取 package.json、README.md、tsconfig.json 等关键文件
-3. 用 codegraph 或 grep 找到主入口、核心模块、关键接口
-4. 理解架构模式、数据流向、调用关系
-5. 识别命名约定、代码风格、测试策略
-6. 找出可能的坑点（复杂配置、特殊依赖、构建陷阱）
-
-## 输出
-探索完成后，将完整的 skill 文档输出在 \`\`\`skill-start 和 \`\`\`skill-end 之间。
-
-记住：内容要精简、可操作、有具体路径和例子。总长度控制在 4000-5000 字符。`;
-    }
-    try {
-        const result = await spawnAgent({
-            prompt,
-            systemPromptSuffix: SKILL_INIT_SUFFIX,
-            tools: ['read_file', 'glob', 'grep', 'codegraph'],
-            maxSteps: 30,
-            signal,
-        });
-        if (!result.completed) {
-            return {
-                ok: false,
-                error: '子 agent 未完成（可能中断或超时）',
-                transcript: result.transcript,
-            };
-        }
-        if (!result.summary) {
-            return {
-                ok: false,
-                error: '子 agent 未返回内容',
-                transcript: result.transcript,
-            };
-        }
-        // 从 summary 中提取 skill 内容
-        const skillMatch = result.summary.match(/```skill-start\n([\s\S]*?)\n```skill-end/);
-        if (!skillMatch || !skillMatch[1]) {
-            // 如果没有找到 delimiters，尝试从最后一段 markdown 代码块提取
-            const codeBlockMatch = result.summary.match(/```(?:markdown|md)?\n([\s\S]*?)\n```/);
-            if (codeBlockMatch && codeBlockMatch[1]) {
-                return {
-                    ok: true,
-                    content: codeBlockMatch[1].trim(),
-                    transcript: result.transcript,
-                };
-            }
-            // 如果连代码块都没有，直接用 summary（但去掉开头的探索日志）
-            const lines = result.summary.split('\n');
-            const skillStartIdx = lines.findIndex((l) => l.startsWith('## '));
-            if (skillStartIdx > 0) {
-                return {
-                    ok: true,
-                    content: lines.slice(skillStartIdx).join('\n').trim(),
-                    transcript: result.transcript,
-                };
-            }
-            return {
-                ok: false,
-                error: '无法从子 agent 输出中提取 skill 内容',
-                transcript: result.transcript,
-            };
-        }
-        const content = skillMatch[1].trim();
-        // 检查长度
-        if (content.length > 6000) {
-            return {
-                ok: false,
-                error: `生成内容过长 (${content.length} 字符)，请手动精简后重试`,
-                transcript: result.transcript,
-            };
-        }
-        return {
-            ok: true,
-            content,
-            transcript: result.transcript,
-        };
-    }
-    catch (e) {
-        return {
-            ok: false,
-            error: e instanceof Error ? e.message : '未知错误',
-            transcript: '',
-        };
-    }
-}