@skj1724/oh-my-opencode 3.18.28 → 3.19.3

package/dist/config/schema.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/background-agent/concurrency.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/background-agent/index.d.ts

@@ -1,4 +1,3 @@
 export * from "./types";
-export { BackgroundManager, type SubagentSessionCreatedEvent, type OnSubagentSessionCreated } from "./manager";
-export { waitForTaskSessionID } from "./wait-for-task-session";
-export type { WaitForTaskSessionIDOptions } from "./wait-for-task-session";
+export { BackgroundManager } from "./manager";
+export { ConcurrencyManager } from "./concurrency";

package/dist/features/background-agent/manager.d.ts

@@ -1,8 +1,6 @@
 import type { PluginInput } from "@opencode-ai/plugin";
 import type { BackgroundTask, LaunchInput, ResumeInput } from "./types";
-import { TaskHistory } from "./task-history";
-import type { BackgroundTaskConfig, TmuxConfig } from "../../config/schema";
-import { type SubagentSpawnContext } from "./subagent-spawn-limits";
+import type { BackgroundTaskConfig } from "../../config/schema";
 interface EventProperties {
     sessionID?: string;
     info?: {
@@ -14,59 +12,22 @@ interface Event {
     type: string;
     properties?: EventProperties;
 }
-export interface SubagentSessionCreatedEvent {
-    sessionID: string;
-    parentID: string;
-    title: string;
-}
-export type OnSubagentSessionCreated = (event: SubagentSessionCreatedEvent) => Promise<void>;
 export declare class BackgroundManager {
+    private static cleanupManagers;
+    private static cleanupRegistered;
+    private static cleanupHandlers;
     private tasks;
     private notifications;
-    private pendingNotifications;
     private pendingByParent;
     private client;
     private directory;
     private pollingInterval?;
-    private pollingInFlight;
     private concurrencyManager;
     private shutdownTriggered;
     private config?;
-    private tmuxEnabled;
-    private onSubagentSessionCreated?;
-    private onShutdown?;
     private queuesByKey;
     private processingKeys;
-    private completionTimers;
-    private completedTaskSummaries;
-    private idleDeferralTimers;
-    private notificationQueueByParent;
-    private observedOutputSessions;
-    private observedIncompleteTodosBySession;
-    private rootDescendantCounts;
-    private preStartDescendantReservations;
-    private enableParentSessionNotifications;
-    readonly taskHistory: TaskHistory;
-    private cachedCircuitBreakerSettings?;
-    constructor(ctx: PluginInput, config?: BackgroundTaskConfig, options?: {
-        tmuxConfig?: TmuxConfig;
-        onSubagentSessionCreated?: OnSubagentSessionCreated;
-        onShutdown?: () => void | Promise<void>;
-        enableParentSessionNotifications?: boolean;
-    });
-    private abortSessionWithLogging;
-    assertCanSpawn(parentSessionID: string): Promise<SubagentSpawnContext>;
-    reserveSubagentSpawn(parentSessionID: string): Promise<{
-        spawnContext: SubagentSpawnContext;
-        descendantCount: number;
-        commit: () => number;
-        rollback: () => void;
-    }>;
-    private registerRootDescendant;
-    private unregisterRootDescendant;
-    private markPreStartDescendantReservation;
-    private settlePreStartDescendantReservation;
-    private rollbackPreStartDescendantReservation;
+    constructor(ctx: PluginInput, config?: BackgroundTaskConfig);
     launch(input: LaunchInput): Promise<BackgroundTask>;
     private processKey;
     private startTask;
@@ -76,7 +37,7 @@ export declare class BackgroundManager {
     findBySession(sessionID: string): BackgroundTask | undefined;
     private getConcurrencyKeyFromInput;
     /**
-     * Track a task created elsewhere (e.g., from task) for notification tracking.
+     * Track a task created elsewhere (e.g., from delegate_task) for notification tracking.
      * This allows tasks created by other tools to receive the same toast/prompt notifications.
      */
     trackTask(input: {
@@ -90,24 +51,10 @@ export declare class BackgroundManager {
     }): Promise<BackgroundTask>;
     resume(input: ResumeInput): Promise<BackgroundTask>;
     private checkSessionTodos;
-    private markSessionOutputObserved;
-    private clearSessionOutputObserved;
-    private clearSessionTodoObservation;
-    private hasOutputSignalFromPart;
     handleEvent(event: Event): void;
-    private handleSessionErrorEvent;
-    private tryFallbackRetry;
     markForNotification(task: BackgroundTask): void;
     getPendingNotifications(sessionID: string): BackgroundTask[];
     clearNotifications(sessionID: string): void;
-    queuePendingNotification(sessionID: string | undefined, notification: string): void;
-    injectPendingNotificationsIntoChatMessage(output: {
-        parts: Array<{
-            type: string;
-            text?: string;
-            [key: string]: unknown;
-        }>;
-    }, sessionID: string): void;
     /**
      * Validates that a session has actual assistant/tool output before marking complete.
      * Prevents premature completion when session.idle fires before agent responds.
@@ -119,14 +66,6 @@ export declare class BackgroundManager {
      * Cleans up the parent entry if no pending tasks remain.
      */
     private cleanupPendingByParent;
-    private clearTaskHistoryWhenParentTasksGone;
-    private scheduleTaskRemoval;
-    cancelTask(taskId: string, options?: {
-        source?: string;
-        reason?: string;
-        abortSession?: boolean;
-        skipNotification?: boolean;
-    }): Promise<boolean>;
     /**
      * Cancels a pending task by removing it from queue and marking as cancelled.
      * Does NOT abort session (no session exists yet) or release concurrency slot (wasn't acquired).
@@ -141,27 +80,25 @@ export declare class BackgroundManager {
      */
     getRunningTasks(): BackgroundTask[];
     /**
-     * Get all non-running tasks still in memory (for compaction hook)
+     * Get all completed tasks still in memory (for compaction hook)
      */
-    getNonRunningTasks(): BackgroundTask[];
+    getCompletedTasks(): BackgroundTask[];
     /**
      * Safely complete a task with race condition protection.
      * Returns true if task was successfully completed, false if already completed by another path.
      */
     private tryCompleteTask;
     private notifyParentSession;
+    private formatDuration;
     private hasRunningTasks;
     private pruneStaleTasksAndNotifications;
     private checkAndInterruptStaleTasks;
-    private verifySessionExists;
-    private failCrashedTask;
     private pollRunningTasks;
     /**
      * Shutdown the manager gracefully.
      * Cancels all pending concurrency waiters and clears timers.
      * Should be called when the plugin is unloaded.
      */
-    shutdown(): Promise<void>;
-    private enqueueNotificationForParent;
+    shutdown(): void;
 }
 export {};

package/dist/features/background-agent/manager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/background-agent/types.d.ts

@@ -1,17 +1,7 @@
-import type { FallbackEntry } from "../../shared/model-requirements";
-import type { DelegatedModelConfig } from "../../shared/model-resolution-types";
-import type { SessionPermissionRule } from "../../shared/question-denied-session-permission";
-export type BackgroundTaskStatus = "pending" | "running" | "completed" | "error" | "cancelled" | "interrupt";
-export interface ToolCallWindow {
-    lastSignature: string;
-    consecutiveCount: number;
-    threshold: number;
-}
+export type BackgroundTaskStatus = "pending" | "running" | "completed" | "error" | "cancelled";
 export interface TaskProgress {
     toolCalls: number;
     lastTool?: string;
-    toolCallWindow?: ToolCallWindow;
-    countedToolPartIDs?: Set<string>;
     lastUpdate: Date;
     lastMessage?: string;
     lastMessageAt?: Date;
@@ -19,13 +9,11 @@ export interface TaskProgress {
 export interface BackgroundTask {
     id: string;
     sessionID?: string;
-    rootSessionID?: string;
     parentSessionID: string;
     parentMessageID: string;
     description: string;
     prompt: string;
     agent: string;
-    spawnDepth?: number;
     status: BackgroundTaskStatus;
     queuedAt?: Date;
     startedAt?: Date;
@@ -37,29 +25,21 @@ export interface BackgroundTask {
         providerID: string;
         modelID: string;
     };
-    model?: DelegatedModelConfig;
-    /** Fallback chain for runtime retry on model errors */
-    fallbackChain?: FallbackEntry[];
-    /** Number of fallback retry attempts made */
-    attemptCount?: number;
+    model?: {
+        providerID: string;
+        modelID: string;
+        variant?: string;
+    };
     /** Active concurrency slot key */
     concurrencyKey?: string;
     /** Persistent key for re-acquiring concurrency on resume */
     concurrencyGroup?: string;
     /** Parent session's agent name for notification */
     parentAgent?: string;
-    /** Parent session's tool restrictions for notification prompts */
-    parentTools?: Record<string, boolean>;
-    /** Marks if the task was launched from an unstable agent/category */
-    isUnstableAgent?: boolean;
-    /** Category used for this task (e.g., 'quick', 'visual-engineering') */
-    category?: string;
     /** Last message count for stability detection */
     lastMsgCount?: number;
     /** Number of consecutive polls with stable message count */
     stablePolls?: number;
-    /** Number of consecutive polls where session was missing from status map */
-    consecutiveMissedPolls?: number;
 }
 export interface LaunchInput {
     description: string;
@@ -72,15 +52,13 @@ export interface LaunchInput {
         modelID: string;
     };
     parentAgent?: string;
-    parentTools?: Record<string, boolean>;
-    model?: DelegatedModelConfig;
-    /** Fallback chain for runtime retry on model errors */
-    fallbackChain?: FallbackEntry[];
-    isUnstableAgent?: boolean;
+    model?: {
+        providerID: string;
+        modelID: string;
+        variant?: string;
+    };
     skills?: string[];
     skillContent?: string;
-    category?: string;
-    sessionPermission?: SessionPermissionRule[];
 }
 export interface ResumeInput {
     sessionId: string;
@@ -92,5 +70,4 @@ export interface ResumeInput {
         modelID: string;
     };
     parentAgent?: string;
-    parentTools?: Record<string, boolean>;
 }

package/dist/features/boulder-state/index.d.ts

@@ -1,4 +1,3 @@
 export * from "./types";
 export * from "./constants";
 export * from "./storage";
-export * from "./top-level-task";

package/dist/features/boulder-state/storage.d.ts

@@ -3,21 +3,12 @@
  *
  * Handles reading/writing boulder.json for active plan tracking.
  */
-import type { BoulderState, PlanProgress, TaskSessionState } from "./types";
+import type { BoulderState, PlanProgress } from "./types";
 export declare function getBoulderFilePath(directory: string): string;
 export declare function readBoulderState(directory: string): BoulderState | null;
 export declare function writeBoulderState(directory: string, state: BoulderState): boolean;
-export declare function appendSessionId(directory: string, sessionId: string, origin?: "direct" | "appended"): BoulderState | null;
+export declare function appendSessionId(directory: string, sessionId: string): BoulderState | null;
 export declare function clearBoulderState(directory: string): boolean;
-export declare function getTaskSessionState(directory: string, taskKey: string): TaskSessionState | null;
-export declare function upsertTaskSessionState(directory: string, input: {
-    taskKey: string;
-    taskLabel: string;
-    taskTitle: string;
-    sessionId: string;
-    agent?: string;
-    category?: string;
-}): BoulderState | null;
 /**
  * Find Prometheus plan files for this project.
  * Prometheus stores plans at: {project}/.sisyphus/plans/{name}.md
@@ -25,13 +16,6 @@ export declare function upsertTaskSessionState(directory: string, input: {
 export declare function findPrometheusPlans(directory: string): string[];
 /**
  * Parse a plan file and count checkbox progress.
- *
- * Only top-level (zero-indent) checkboxes under `## TODOs` and
- * `## Final Verification Wave` sections are counted. The checkbox
- * body must carry a valid task label (`N.` for TODOs, `FN.` for
- * Final Verification Wave). Nested acceptance-criteria checkboxes
- * and checkboxes in other sections are intentionally ignored so
- * that progress tracking stays aligned with `readCurrentTopLevelTask`.
  */
 export declare function getPlanProgress(planPath: string): PlanProgress;
 /**
@@ -41,4 +25,4 @@ export declare function getPlanName(planPath: string): string;
 /**
  * Create a new boulder state for a plan.
  */
-export declare function createBoulderState(planPath: string, sessionId: string, agent?: string, worktreePath?: string): BoulderState;
+export declare function createBoulderState(planPath: string, sessionId: string): BoulderState;

package/dist/features/boulder-state/storage.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/boulder-state/types.d.ts

@@ -11,15 +11,8 @@ export interface BoulderState {
     started_at: string;
     /** Session IDs that have worked on this plan */
     session_ids: string[];
-    session_origins?: Record<string, "direct" | "appended">;
     /** Plan name derived from filename */
     plan_name: string;
-    /** Agent type to use when resuming (e.g., 'atlas') */
-    agent?: string;
-    /** Absolute path to the git worktree root where work happens */
-    worktree_path?: string;
-    /** Preferred reusable subagent sessions keyed by current top-level plan task */
-    task_sessions?: Record<string, TaskSessionState>;
 }
 export interface PlanProgress {
     /** Total number of checkboxes */
@@ -29,29 +22,3 @@ export interface PlanProgress {
     /** Whether all tasks are done */
     isComplete: boolean;
 }
-export interface TaskSessionState {
-    /** Stable identifier for the current top-level plan task (e.g. todo:1 / final-wave:F1) */
-    task_key: string;
-    /** Original task label from the plan file */
-    task_label: string;
-    /** Full task title from the plan file */
-    task_title: string;
-    /** Preferred reusable subagent session */
-    session_id: string;
-    /** Agent associated with the task session, when known */
-    agent?: string;
-    /** Category associated with the task session, when known */
-    category?: string;
-    /** Last update timestamp */
-    updated_at: string;
-}
-export interface TopLevelTaskRef {
-    /** Stable identifier for the current top-level plan task */
-    key: string;
-    /** Task section in the Prometheus plan */
-    section: "todo" | "final-wave";
-    /** Original label token (e.g. 1 / F1) */
-    label: string;
-    /** Full task title extracted from the checkbox line */
-    title: string;
-}

package/dist/features/builtin-commands/commands.d.ts

@@ -1,6 +1,2 @@
 import type { BuiltinCommandName, BuiltinCommands } from "./types";
-interface LoadBuiltinCommandsOptions {
-    useRegisteredAgents?: boolean;
-}
-export declare function loadBuiltinCommands(disabledCommands?: BuiltinCommandName[], options?: LoadBuiltinCommandsOptions): BuiltinCommands;
-export {};
+export declare function loadBuiltinCommands(disabledCommands?: BuiltinCommandName[]): BuiltinCommands;

package/dist/features/builtin-commands/templates/init-deep.d.ts

@@ -1 +1 @@
-export declare const INIT_DEEP_TEMPLATE = "# /init-deep\n\n\u751F\u6210\u5206\u5C42 AGENTS.md \u6587\u4EF6\u3002\u6839\u76EE\u5F55 + \u590D\u6742\u5EA6\u8BC4\u5206\u5B50\u76EE\u5F55\u3002\n\n## \u4F7F\u7528\u65B9\u6CD5\n\n```\n/init-deep                      # Update mode: modify existing + create new where warranted\n/init-deep --create-new         # Read existing \u2192 remove all \u2192 regenerate from scratch\n/init-deep --max-depth=2        # Limit directory depth (default: 3)\n```\n\n---\n\n## \u5DE5\u4F5C\u6D41\u7A0B\uFF08\u9AD8\u7EA7\uFF09\n\n1. **\u53D1\u73B0 + \u5206\u6790**\uFF08\u5E76\u53D1\uFF09\n   - \u7ACB\u5373\u89E6\u53D1\u540E\u53F0\u63A2\u7D22\u4EE3\u7406\n   - \u4E3B\u4F1A\u8BDD\uFF1Abash \u7ED3\u6784 + LSP \u4EE3\u7801\u6620\u5C04 + \u8BFB\u53D6\u73B0\u6709 AGENTS.md\n2. **\u8BC4\u5206\u4E0E\u51B3\u7B56** - \u6839\u636E\u5408\u5E76\u7ED3\u679C\u786E\u5B9A AGENTS.md \u4F4D\u7F6E\n3. **\u751F\u6210** - \u5148\u6839\u76EE\u5F55\uFF0C\u7136\u540E\u5E76\u884C\u5B50\u76EE\u5F55\n4. **\u5BA1\u67E5** - \u53BB\u91CD\u3001\u7CBE\u7B80\u3001\u9A8C\u8BC1\n\n<critical>\n**\u7528 TodoWrite \u8BB0\u5F55\u6240\u6709\u9636\u6BB5\u3002\u5B9E\u65F6\u6807\u8BB0 in_progress \u2192 completed\u3002**\n```\nTodoWrite([\n  { id: \"discovery\", content: \"Fire explore agents + LSP codemap + read existing\", status: \"pending\", priority: \"high\" },\n  { id: \"scoring\", content: \"Score directories, determine locations\", status: \"pending\", priority: \"high\" },\n  { id: \"generate\", content: \"Generate AGENTS.md files (root + subdirs)\", status: \"pending\", priority: \"high\" },\n  { id: \"review\", content: \"Deduplicate, validate, trim\", status: \"pending\", priority: \"medium\" }\n])\n```\n</critical>\n\n---\n\n## \u9636\u6BB5 1\uFF1A\u53D1\u73B0 + \u5206\u6790\uFF08\u5E76\u53D1\uFF09\n\n**\u5C06 \"discovery\" \u6807\u8BB0\u4E3A in_progress\u3002**\n\n### \u7ACB\u5373\u89E6\u53D1\u540E\u53F0\u63A2\u7D22\u4EE3\u7406\n\n\u4E0D\u8981\u7B49\u5F85\u2014\u2014\u8FD9\u4E9B\u4EE3\u7406\u5728\u4E3B\u4F1A\u8BDD\u5DE5\u4F5C\u65F6\u5F02\u6B65\u8FD0\u884C\u3002\n\n```\n// Fire all at once, collect results later\ntask(subagent_type=\"explore\", load_skills=[], description=\"Explore project structure\", run_in_background=true, prompt=\"Project structure: PREDICT standard patterns for detected language \u2192 REPORT deviations only\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Find entry points\", run_in_background=true, prompt=\"Entry points: FIND main files \u2192 REPORT non-standard organization\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Find conventions\", run_in_background=true, prompt=\"Conventions: FIND config files (.eslintrc, pyproject.toml, .editorconfig) \u2192 REPORT project-specific rules\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Find anti-patterns\", run_in_background=true, prompt=\"Anti-patterns: FIND 'DO NOT', 'NEVER', 'ALWAYS', 'DEPRECATED' comments \u2192 LIST forbidden patterns\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Explore build/CI\", run_in_background=true, prompt=\"Build/CI: FIND .github/workflows, Makefile \u2192 REPORT non-standard patterns\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Find test patterns\", run_in_background=true, prompt=\"Test patterns: FIND test configs, test structure \u2192 REPORT unique conventions\")\n```\n\n<dynamic-agents>\n**\u52A8\u6001\u4EE3\u7406\u751F\u6210**\uFF1A\u5728 bash \u5206\u6790\u4E4B\u540E\uFF0C\u6839\u636E\u9879\u76EE\u89C4\u6A21\u751F\u6210\u989D\u5916\u7684\u63A2\u7D22\u4EE3\u7406\uFF1A\n\n| \u56E0\u7D20 | \u9608\u503C | \u989D\u5916\u4EE3\u7406\u6570 |\n|--------|-----------|-------------------|\n| **\u603B\u6587\u4EF6\u6570** | >100 | \u6BCF 100 \u4E2A\u6587\u4EF6 +1 |\n| **\u603B\u884C\u6570** | >10k | \u6BCF 10k \u884C +1 |\n| **\u76EE\u5F55\u6DF1\u5EA6** | \u22654 | \u6DF1\u5EA6\u63A2\u7D22 +2 |\n| **\u5927\u6587\u4EF6\uFF08>500 \u884C\uFF09** | >10 \u4E2A\u6587\u4EF6 | \u590D\u6742\u5EA6\u70ED\u70B9 +1 |\n| **Monorepo** | \u68C0\u6D4B\u5230 | \u6BCF\u4E2A\u5305/\u5DE5\u4F5C\u7A7A\u95F4 +1 |\n| **\u591A\u8BED\u8A00** | >1 | \u6BCF\u79CD\u8BED\u8A00 +1 |\n\n```bash\n# Measure project scale first\ntotal_files=$(find . -type f -not -path '*/node_modules/*' -not -path '*/.git/*' | wc -l)\ntotal_lines=$(find . -type f \\( -name \"*.ts\" -o -name \"*.py\" -o -name \"*.go\" \\) -not -path '*/node_modules/*' -exec wc -l {} + 2>/dev/null | tail -1 | awk '{print $1}')\nlarge_files=$(find . -type f \\( -name \"*.ts\" -o -name \"*.py\" \\) -not -path '*/node_modules/*' -exec wc -l {} + 2>/dev/null | awk '$1 > 500 {count++} END {print count+0}')\nmax_depth=$(find . -type d -not -path '*/node_modules/*' -not -path '*/.git/*' | awk -F/ '{print NF}' | sort -rn | head -1)\n```\n\nExample spawning:\n```\n// 500 files, 50k lines, depth 6, 15 large files \u2192 spawn 5+5+2+1 = 13 additional agents\ntask(subagent_type=\"explore\", load_skills=[], description=\"Analyze large files\", run_in_background=true, prompt=\"Large file analysis: FIND files >500 lines, REPORT complexity hotspots\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Explore deep modules\", run_in_background=true, prompt=\"Deep modules at depth 4+: FIND hidden patterns, internal conventions\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Find shared utilities\", run_in_background=true, prompt=\"Cross-cutting concerns: FIND shared utilities across directories\")\n// ... more based on calculation\n```\n</dynamic-agents>\n\n### \u4E3B\u4F1A\u8BDD\uFF1A\u5E76\u53D1\u5206\u6790\n\n**\u5728\u540E\u53F0\u4EE3\u7406\u8FD0\u884C\u65F6**\uFF0C\u4E3B\u4F1A\u8BDD\u6267\u884C\u4EE5\u4E0B\u64CD\u4F5C\uFF1A\n\n#### 1. Bash \u7ED3\u6784\u5206\u6790\n```bash\n# Directory depth + file counts\nfind . -type d -not -path '*/\\.*' -not -path '*/node_modules/*' -not -path '*/venv/*' -not -path '*/dist/*' -not -path '*/build/*' | awk -F/ '{print NF-1}' | sort -n | uniq -c\n\n# Files per directory (top 30)\nfind . -type f -not -path '*/\\.*' -not -path '*/node_modules/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -30\n\n# Code concentration by extension\nfind . -type f \\( -name \"*.py\" -o -name \"*.ts\" -o -name \"*.tsx\" -o -name \"*.js\" -o -name \"*.go\" -o -name \"*.rs\" \\) -not -path '*/node_modules/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -20\n\n# Existing AGENTS.md / CLAUDE.md\nfind . -type f \\( -name \"AGENTS.md\" -o -name \"CLAUDE.md\" \\) -not -path '*/node_modules/*' 2>/dev/null\n```\n\n#### 2. \u8BFB\u53D6\u73B0\u6709 AGENTS.md\n```\nFor each existing file found:\n  Read(filePath=file)\n  Extract: key insights, conventions, anti-patterns\n  Store in EXISTING_AGENTS map\n```\n\n\u5982\u679C\u4F7F\u7528 `--create-new`\uFF1A\u5148\u8BFB\u53D6\u6240\u6709\u73B0\u6709\u6587\u4EF6\uFF08\u4FDD\u7559\u4E0A\u4E0B\u6587\uFF09\u2192 \u7136\u540E\u5220\u9664\u6240\u6709 \u2192 \u91CD\u65B0\u751F\u6210\u3002\n\n#### 3. LSP \u4EE3\u7801\u6620\u5C04\uFF08\u5982\u53EF\u7528\uFF09\n```\nLspServers()  # Check availability\n\n# Entry points (parallel)\nLspDocumentSymbols(filePath=\"src/index.ts\")\nLspDocumentSymbols(filePath=\"main.py\")\n\n# Key symbols (parallel)\nLspWorkspaceSymbols(filePath=\".\", query=\"class\")\nLspWorkspaceSymbols(filePath=\".\", query=\"interface\")\nLspWorkspaceSymbols(filePath=\".\", query=\"function\")\n\n# Centrality for top exports\nLspFindReferences(filePath=\"...\", line=X, character=Y)\n```\n\n**LSP \u964D\u7EA7\u65B9\u6848**\uFF1A\u5982\u679C\u4E0D\u53EF\u7528\uFF0C\u4F9D\u8D56\u63A2\u7D22\u4EE3\u7406 + AST-grep\u3002\n\n### \u6536\u96C6\u540E\u53F0\u7ED3\u679C\n\n```\n// After main session analysis done, collect all task results\nfor each task_id: background_output(task_id=\"...\")\n```\n\n**\u5408\u5E76\uFF1Abash + LSP + \u73B0\u6709\u6587\u4EF6 + \u63A2\u7D22\u7ED3\u679C\u3002\u5C06 \"discovery\" \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n## \u9636\u6BB5 2\uFF1A\u8BC4\u5206\u4E0E\u4F4D\u7F6E\u51B3\u7B56\n\n**\u5C06 \"scoring\" \u6807\u8BB0\u4E3A in_progress\u3002**\n\n### \u8BC4\u5206\u77E9\u9635\n\n| \u56E0\u7D20 | \u6743\u91CD | \u9AD8\u9608\u503C | \u6570\u636E\u6765\u6E90 |\n|--------|--------|----------------|--------|\n| \u6587\u4EF6\u6570\u91CF | 3x | >20 | bash |\n| \u5B50\u76EE\u5F55\u6570\u91CF | 2x | >5 | bash |\n| \u4EE3\u7801\u5360\u6BD4 | 2x | >70% | bash |\n| \u72EC\u7279\u6A21\u5F0F | 1x | \u6709\u81EA\u6709\u914D\u7F6E | explore |\n| \u6A21\u5757\u8FB9\u754C | 2x | \u6709 index.ts/__init__.py | bash |\n| \u7B26\u53F7\u5BC6\u5EA6 | 2x | >30 \u4E2A\u7B26\u53F7 | LSP |\n| \u5BFC\u51FA\u6570\u91CF | 2x | >10 \u4E2A\u5BFC\u51FA | LSP |\n| \u5F15\u7528\u4E2D\u5FC3\u5EA6 | 3x | >20 \u6B21\u5F15\u7528 | LSP |\n\n### \u51B3\u7B56\u89C4\u5219\n\n| \u5206\u6570 | \u64CD\u4F5C |\n|-------|--------|\n| **\u6839\u76EE\u5F55\uFF08.\uFF09** | \u59CB\u7EC8\u521B\u5EFA |\n| **>15** | \u521B\u5EFA AGENTS.md |\n| **8-15** | \u5982\u679C\u662F\u72EC\u7ACB\u9886\u57DF\u5219\u521B\u5EFA |\n| **<8** | \u8DF3\u8FC7\uFF08\u7236\u76EE\u5F55\u5DF2\u8986\u76D6\uFF09 |\n\n### \u8F93\u51FA\n```\nAGENTS_LOCATIONS = [\n  { path: \".\", type: \"root\" },\n  { path: \"src/hooks\", score: 18, reason: \"high complexity\" },\n  { path: \"src/api\", score: 12, reason: \"distinct domain\" }\n]\n```\n\n**\u5C06 \"scoring\" \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n## \u9636\u6BB5 3\uFF1A\u751F\u6210 AGENTS.md\n\n**\u5C06 \"generate\" \u6807\u8BB0\u4E3A in_progress\u3002**\n\n<critical>\n**\u6587\u4EF6\u5199\u5165\u89C4\u5219**\uFF1A\u5982\u679C\u76EE\u6807\u8DEF\u5F84\u5DF2\u5B58\u5728 AGENTS.md \u2192 \u4F7F\u7528 `Edit` \u5DE5\u5177\u3002\u5982\u679C\u4E0D\u5B58\u5728 \u2192 \u4F7F\u7528 `Write` \u5DE5\u5177\u3002\n\u7EDD\u4E0D\u8981\u4F7F\u7528 Write \u8986\u76D6\u73B0\u6709\u6587\u4EF6\u3002\u59CB\u7EC8\u901A\u8FC7 `Read` \u6216\u53D1\u73B0\u7ED3\u679C\u5148\u68C0\u67E5\u662F\u5426\u5B58\u5728\u3002\n</critical>\n\n### \u6839\u76EE\u5F55 AGENTS.md\uFF08\u5B8C\u6574\u5904\u7406\uFF09\n\n```markdown\n# PROJECT KNOWLEDGE BASE\n\n**Generated:** {TIMESTAMP}\n**Commit:** {SHORT_SHA}\n**Branch:** {BRANCH}\n\n## OVERVIEW\n{1-2 sentences: what + core stack}\n\n## STRUCTURE\n\\`\\`\\`\n{root}/\n\u251C\u2500\u2500 {dir}/    # {non-obvious purpose only}\n\u2514\u2500\u2500 {entry}\n\\`\\`\\`\n\n## WHERE TO LOOK\n| Task | Location | Notes |\n|------|----------|-------|\n\n## CODE MAP\n{From LSP - skip if unavailable or project <10 files}\n\n| Symbol | Type | Location | Refs | Role |\n|--------|------|----------|------|------|\n\n## CONVENTIONS\n{ONLY deviations from standard}\n\n## ANTI-PATTERNS (THIS PROJECT)\n{Explicitly forbidden here}\n\n## UNIQUE STYLES\n{Project-specific}\n\n## COMMANDS\n\\`\\`\\`bash\n{dev/test/build}\n\\`\\`\\`\n\n## NOTES\n{Gotchas}\n```\n\n**\u8D28\u91CF\u6807\u51C6**\uFF1A50-150 \u884C\uFF0C\u65E0\u901A\u7528\u5EFA\u8BAE\uFF0C\u65E0\u663E\u800C\u6613\u89C1\u7684\u4FE1\u606F\u3002\n\n### \u5B50\u76EE\u5F55 AGENTS.md\uFF08\u5E76\u884C\uFF09\n\n\u4E3A\u6BCF\u4E2A\u4F4D\u7F6E\u542F\u52A8\u5199\u5165\u4EFB\u52A1\uFF1A\n\n```\nfor loc in AGENTS_LOCATIONS (except root):\n  task(category=\"writing\", load_skills=[], run_in_background=false, description=\"Generate AGENTS.md\", prompt=\\`\n    Generate AGENTS.md for: ${loc.path}\n    - Reason: ${loc.reason}\n    - 30-80 lines max\n    - NEVER repeat parent content\n    - Sections: OVERVIEW (1 line), STRUCTURE (if >5 subdirs), WHERE TO LOOK, CONVENTIONS (if different), ANTI-PATTERNS\n  \\`)\n```\n\n**\u7B49\u5F85\u6240\u6709\u5B8C\u6210\u3002\u5C06 \"generate\" \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n## \u9636\u6BB5 4\uFF1A\u5BA1\u67E5\u4E0E\u53BB\u91CD\n\n**\u5C06 \"review\" \u6807\u8BB0\u4E3A in_progress\u3002**\n\n\u5BF9\u6BCF\u4E2A\u751F\u6210\u7684\u6587\u4EF6\uFF1A\n- \u79FB\u9664\u901A\u7528\u5EFA\u8BAE\n- \u79FB\u9664\u4E0E\u7236\u76EE\u5F55\u91CD\u590D\u7684\u5185\u5BB9\n- \u7CBE\u7B80\u5230\u5927\u5C0F\u9650\u5236\n- \u9A8C\u8BC1\u7B80\u6D01\u98CE\u683C\n\n**\u5C06 \"review\" \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n## \u6700\u7EC8\u62A5\u544A\n\n```\n=== init-deep Complete ===\n\nMode: {update | create-new}\n\nFiles:\n  [OK] ./AGENTS.md (root, {N} lines)\n  [OK] ./src/hooks/AGENTS.md ({N} lines)\n\nDirs Analyzed: {N}\nAGENTS.md Created: {N}\nAGENTS.md Updated: {N}\n\nHierarchy:\n  ./AGENTS.md\n  \u2514\u2500\u2500 src/hooks/AGENTS.md\n```\n\n---\n\n## \u53CD\u6A21\u5F0F\n\n- **\u9759\u6001\u4EE3\u7406\u6570\u91CF**\uFF1A\u5FC5\u987B\u6839\u636E\u9879\u76EE\u89C4\u6A21/\u6DF1\u5EA6\u53D8\u5316\u4EE3\u7406\u6570\u91CF\n- **\u987A\u5E8F\u6267\u884C**\uFF1A\u5FC5\u987B\u5E76\u884C\u5316\uFF08\u63A2\u7D22 + LSP \u5E76\u53D1\uFF09\n- **\u5FFD\u7565\u73B0\u6709\u6587\u4EF6**\uFF1A\u59CB\u7EC8\u5148\u8BFB\u53D6\u73B0\u6709\u6587\u4EF6\uFF0C\u5373\u4F7F\u4F7F\u7528 --create-new\n- **\u8FC7\u5EA6\u6587\u6863\u5316**\uFF1A\u5E76\u975E\u6BCF\u4E2A\u76EE\u5F55\u90FD\u9700\u8981 AGENTS.md\n- **\u5197\u4F59**\uFF1A\u5B50\u76EE\u5F55\u7EDD\u4E0D\u91CD\u590D\u7236\u76EE\u5F55\u5185\u5BB9\n- **\u901A\u7528\u5185\u5BB9**\uFF1A\u79FB\u9664\u4EFB\u4F55\u9002\u7528\u4E8E\u6240\u6709\u9879\u76EE\u7684\u5185\u5BB9\n- **\u5197\u4F59\u98CE\u683C**\uFF1A\u7B80\u6D01\u81F3\u4E0A";
+export declare const INIT_DEEP_TEMPLATE = "# /init-deep\n\n\u751F\u6210\u5C42\u6B21\u5316\u7684 AGENTS.md \u6587\u4EF6\u3002\u6839\u76EE\u5F55 + \u6309\u590D\u6742\u5EA6\u8BC4\u5206\u7684\u5B50\u76EE\u5F55\u3002\n\n## \u7528\u6CD5\n\n```\n/init-deep                      # \u66F4\u65B0\u6A21\u5F0F\uFF1A\u4FEE\u6539\u73B0\u6709 + \u5728\u9700\u8981\u65F6\u521B\u5EFA\u65B0\u7684\n/init-deep --create-new         # \u8BFB\u53D6\u73B0\u6709 \u2192 \u5220\u9664\u5168\u90E8 \u2192 \u4ECE\u5934\u91CD\u65B0\u751F\u6210\n/init-deep --max-depth=2        # \u9650\u5236\u76EE\u5F55\u6DF1\u5EA6\uFF08\u9ED8\u8BA4\uFF1A3\uFF09\n```\n\n---\n\n## \u5DE5\u4F5C\u6D41\u7A0B\uFF08\u9AD8\u5C42\u6982\u89C8\uFF09\n\n1. **\u53D1\u73B0 + \u5206\u6790**\uFF08\u5E76\u53D1\uFF09\n   - \u7ACB\u5373\u542F\u52A8\u540E\u53F0 explore \u4EE3\u7406\n   - \u4E3B\u4F1A\u8BDD\uFF1Abash \u7ED3\u6784 + LSP \u4EE3\u7801\u6620\u5C04 + \u8BFB\u53D6\u73B0\u6709 AGENTS.md\n2. **\u8BC4\u5206\u4E0E\u51B3\u7B56** - \u6839\u636E\u5408\u5E76\u7ED3\u679C\u786E\u5B9A AGENTS.md \u4F4D\u7F6E\n3. **\u751F\u6210** - \u5148\u6839\u76EE\u5F55\uFF0C\u7136\u540E\u5E76\u884C\u5904\u7406\u5B50\u76EE\u5F55\n4. **\u5BA1\u67E5** - \u53BB\u91CD\u3001\u7CBE\u7B80\u3001\u9A8C\u8BC1\n\n<critical>\n**\u5BF9 ALL \u9636\u6BB5\u4F7F\u7528 TodoWrite\u3002\u5B9E\u65F6\u6807\u8BB0 in_progress \u2192 completed\u3002**\n```\nTodoWrite([\n  { id: \"discovery\", content: \"\u542F\u52A8 explore \u4EE3\u7406 + LSP \u4EE3\u7801\u6620\u5C04 + \u8BFB\u53D6\u73B0\u6709\u6587\u4EF6\", status: \"pending\", priority: \"high\" },\n  { id: \"scoring\", content: \"\u8BC4\u5206\u76EE\u5F55\uFF0C\u786E\u5B9A\u4F4D\u7F6E\", status: \"pending\", priority: \"high\" },\n  { id: \"generate\", content: \"\u751F\u6210 AGENTS.md \u6587\u4EF6\uFF08\u6839\u76EE\u5F55 + \u5B50\u76EE\u5F55\uFF09\", status: \"pending\", priority: \"high\" },\n  { id: \"review\", content: \"\u53BB\u91CD\u3001\u9A8C\u8BC1\u3001\u7CBE\u7B80\", status: \"pending\", priority: \"medium\" }\n])\n```\n</critical>\n\n---\n\n## \u9636\u6BB5 1\uFF1A\u53D1\u73B0 + \u5206\u6790\uFF08\u5E76\u53D1\uFF09\n\n**\u5C06 \"discovery\" \u6807\u8BB0\u4E3A in_progress\u3002**\n\n### \u7ACB\u5373\u542F\u52A8\u540E\u53F0 Explore \u4EE3\u7406\n\n\u4E0D\u8981\u7B49\u5F85\u2014\u2014\u5B83\u4EEC\u5728\u4E3B\u4F1A\u8BDD\u5DE5\u4F5C\u7684\u540C\u65F6\u5F02\u6B65\u8FD0\u884C\u3002\n\n```\n// \u4E00\u6B21\u6027\u5168\u90E8\u89E6\u53D1\uFF0C\u7A0D\u540E\u6536\u96C6\u7ED3\u679C\ndelegate_task(agent=\"explore\", prompt=\"Project structure: PREDICT standard patterns for detected language \u2192 REPORT deviations only\")\ndelegate_task(agent=\"explore\", prompt=\"Entry points: FIND main files \u2192 REPORT non-standard organization\")\ndelegate_task(agent=\"explore\", prompt=\"Conventions: FIND config files (.eslintrc, pyproject.toml, .editorconfig) \u2192 REPORT project-specific rules\")\ndelegate_task(agent=\"explore\", prompt=\"Anti-patterns: FIND 'DO NOT', 'NEVER', 'ALWAYS', 'DEPRECATED' comments \u2192 LIST forbidden patterns\")\ndelegate_task(agent=\"explore\", prompt=\"Build/CI: FIND .github/workflows, Makefile \u2192 REPORT non-standard patterns\")\ndelegate_task(agent=\"explore\", prompt=\"Test patterns: FIND test configs, test structure \u2192 REPORT unique conventions\")\n```\n\n<dynamic-agents>\n**\u52A8\u6001\u4EE3\u7406\u751F\u6210**\uFF1A\u5728 bash \u5206\u6790\u4E4B\u540E\uFF0C\u6839\u636E\u9879\u76EE\u89C4\u6A21\u751F\u6210\u989D\u5916\u7684 explore \u4EE3\u7406\uFF1A\n\n| \u56E0\u7D20 | \u9608\u503C | \u989D\u5916\u4EE3\u7406\u6570 |\n|--------|-----------|-------------------|\n| **\u6587\u4EF6\u603B\u6570** | >100 | \u6BCF 100 \u4E2A\u6587\u4EF6 +1 |\n| **\u603B\u884C\u6570** | >10k | \u6BCF 10k \u884C +1 |\n| **\u76EE\u5F55\u6DF1\u5EA6** | >=4 | \u6DF1\u5EA6\u63A2\u7D22 +2 |\n| **\u5927\u6587\u4EF6\uFF08>500 \u884C\uFF09** | >10 \u4E2A\u6587\u4EF6 | \u590D\u6742\u5EA6\u70ED\u70B9 +1 |\n| **Monorepo** | \u68C0\u6D4B\u5230 | \u6BCF\u4E2A\u5305/\u5DE5\u4F5C\u533A +1 |\n| **\u591A\u8BED\u8A00** | >1 | \u6BCF\u79CD\u8BED\u8A00 +1 |\n\n```bash\n# \u9996\u5148\u8861\u91CF\u9879\u76EE\u89C4\u6A21\ntotal_files=$(find . -type f -not -path '*/node_modules/*' -not -path '*/.git/*' | wc -l)\ntotal_lines=$(find . -type f \\( -name \"*.ts\" -o -name \"*.py\" -o -name \"*.go\" \\) -not -path '*/node_modules/*' -exec wc -l {} + 2>/dev/null | tail -1 | awk '{print $1}')\nlarge_files=$(find . -type f \\( -name \"*.ts\" -o -name \"*.py\" \\) -not -path '*/node_modules/*' -exec wc -l {} + 2>/dev/null | awk '$1 > 500 {count++} END {print count+0}')\nmax_depth=$(find . -type d -not -path '*/node_modules/*' -not -path '*/.git/*' | awk -F/ '{print NF}' | sort -rn | head -1)\n```\n\n\u793A\u4F8B\u751F\u6210\uFF1A\n```\n// 500 \u4E2A\u6587\u4EF6\uFF0C50k \u884C\uFF0C\u6DF1\u5EA6 6\uFF0C15 \u4E2A\u5927\u6587\u4EF6 \u2192 \u751F\u6210 5+5+2+1 = 13 \u4E2A\u989D\u5916\u4EE3\u7406\ndelegate_task(agent=\"explore\", prompt=\"Large file analysis: FIND files >500 lines, REPORT complexity hotspots\")\ndelegate_task(agent=\"explore\", prompt=\"Deep modules at depth 4+: FIND hidden patterns, internal conventions\")\ndelegate_task(agent=\"explore\", prompt=\"Cross-cutting concerns: FIND shared utilities across directories\")\n// ... \u6839\u636E\u8BA1\u7B97\u7ED3\u679C\u8FFD\u52A0\u66F4\u591A\n```\n</dynamic-agents>\n\n### \u4E3B\u4F1A\u8BDD\uFF1A\u5E76\u53D1\u5206\u6790\n\n**\u5728\u540E\u53F0\u4EE3\u7406\u8FD0\u884C\u65F6**\uFF0C\u4E3B\u4F1A\u8BDD\u6267\u884C\uFF1A\n\n#### 1. Bash \u7ED3\u6784\u5206\u6790\n```bash\n# \u76EE\u5F55\u6DF1\u5EA6 + \u6587\u4EF6\u8BA1\u6570\nfind . -type d -not -path '*/\\.*' -not -path '*/node_modules/*' -not -path '*/venv/*' -not -path '*/dist/*' -not -path '*/build/*' | awk -F/ '{print NF-1}' | sort -n | uniq -c\n\n# \u6BCF\u4E2A\u76EE\u5F55\u7684\u6587\u4EF6\u6570\uFF08\u524D 30\uFF09\nfind . -type f -not -path '*/\\.*' -not -path '*/node_modules/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -30\n\n# \u6309\u6269\u5C55\u540D\u7684\u4EE3\u7801\u96C6\u4E2D\u5EA6\nfind . -type f \\( -name \"*.py\" -o -name \"*.ts\" -o -name \"*.tsx\" -o -name \"*.js\" -o -name \"*.go\" -o -name \"*.rs\" \\) -not -path '*/node_modules/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -20\n\n# \u73B0\u6709\u7684 AGENTS.md / CLAUDE.md\nfind . -type f \\( -name \"AGENTS.md\" -o -name \"CLAUDE.md\" \\) -not -path '*/node_modules/*' 2>/dev/null\n```\n\n#### 2. \u8BFB\u53D6\u73B0\u6709\u7684 AGENTS.md\n```\nFor each existing file found:\n  Read(filePath=file)\n  Extract: key insights, conventions, anti-patterns\n  Store in EXISTING_AGENTS map\n```\n\n\u5982\u679C\u4F7F\u7528 `--create-new`\uFF1A\u5148\u8BFB\u53D6\u6240\u6709\u73B0\u6709\u6587\u4EF6\uFF08\u4FDD\u7559\u4E0A\u4E0B\u6587\uFF09\u2192 \u7136\u540E\u5220\u9664\u5168\u90E8 \u2192 \u91CD\u65B0\u751F\u6210\u3002\n\n#### 3. LSP \u4EE3\u7801\u6620\u5C04\uFF08\u5982\u53EF\u7528\uFF09\n```\nLspServers()  # \u68C0\u67E5\u53EF\u7528\u6027\n\n# \u5165\u53E3\u70B9\uFF08\u5E76\u884C\uFF09\nLspDocumentSymbols(filePath=\"src/index.ts\")\nLspDocumentSymbols(filePath=\"main.py\")\n\n# \u5173\u952E\u7B26\u53F7\uFF08\u5E76\u884C\uFF09\nLspWorkspaceSymbols(filePath=\".\", query=\"class\")\nLspWorkspaceSymbols(filePath=\".\", query=\"interface\")\nLspWorkspaceSymbols(filePath=\".\", query=\"function\")\n\n# \u9876\u5C42\u5BFC\u51FA\u7684\u4E2D\u5FC3\u6027\nLspFindReferences(filePath=\"...\", line=X, character=Y)\n```\n\n**LSP \u56DE\u9000**\uFF1A\u5982\u679C\u4E0D\u53EF\u7528\uFF0C\u5219\u4F9D\u8D56 explore \u4EE3\u7406 + AST-grep\u3002\n\n### \u6536\u96C6\u540E\u53F0\u7ED3\u679C\n\n```\n// \u4E3B\u4F1A\u8BDD\u5206\u6790\u5B8C\u6210\u540E\uFF0C\u6536\u96C6\u6240\u6709\u4EFB\u52A1\u7ED3\u679C\nfor each task_id: background_output(task_id=\"...\")\n```\n\n**\u5408\u5E76\uFF1Abash + LSP + \u73B0\u6709\u6587\u4EF6 + explore \u53D1\u73B0\u3002\u5C06 \"discovery\" \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n## \u9636\u6BB5 2\uFF1A\u8BC4\u5206\u4E0E\u4F4D\u7F6E\u51B3\u7B56\n\n**\u5C06 \"scoring\" \u6807\u8BB0\u4E3A in_progress\u3002**\n\n### \u8BC4\u5206\u77E9\u9635\n\n| \u56E0\u7D20 | \u6743\u91CD | \u9AD8\u9608\u503C | \u6570\u636E\u6765\u6E90 |\n|--------|--------|----------------|--------|\n| \u6587\u4EF6\u6570 | 3x | >20 | bash |\n| \u5B50\u76EE\u5F55\u6570 | 2x | >5 | bash |\n| \u4EE3\u7801\u5360\u6BD4 | 2x | >70% | bash |\n| \u72EC\u7279\u6A21\u5F0F | 1x | \u6709\u81EA\u5DF1\u7684\u914D\u7F6E | explore |\n| \u6A21\u5757\u8FB9\u754C | 2x | \u6709 index.ts/__init__.py | bash |\n| \u7B26\u53F7\u5BC6\u5EA6 | 2x | >30 \u4E2A\u7B26\u53F7 | LSP |\n| \u5BFC\u51FA\u6570\u91CF | 2x | >10 \u4E2A\u5BFC\u51FA | LSP |\n| \u5F15\u7528\u4E2D\u5FC3\u6027 | 3x | >20 \u6B21\u5F15\u7528 | LSP |\n\n### \u51B3\u7B56\u89C4\u5219\n\n| \u5206\u6570 | \u64CD\u4F5C |\n|-------|--------|\n| **\u6839\u76EE\u5F55\uFF08.\uFF09** | \u59CB\u7EC8\u521B\u5EFA |\n| **>15** | \u521B\u5EFA AGENTS.md |\n| **8-15** | \u5982\u679C\u662F\u72EC\u7ACB\u9886\u57DF\u5219\u521B\u5EFA |\n| **<8** | \u8DF3\u8FC7\uFF08\u7236\u76EE\u5F55\u8986\u76D6\uFF09 |\n\n### \u8F93\u51FA\n```\nAGENTS_LOCATIONS = [\n  { path: \".\", type: \"root\" },\n  { path: \"src/hooks\", score: 18, reason: \"\u9AD8\u590D\u6742\u5EA6\" },\n  { path: \"src/api\", score: 12, reason: \"\u72EC\u7ACB\u9886\u57DF\" }\n]\n```\n\n**\u5C06 \"scoring\" \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n## \u9636\u6BB5 3\uFF1A\u751F\u6210 AGENTS.md\n\n**\u5C06 \"generate\" \u6807\u8BB0\u4E3A in_progress\u3002**\n\n### \u6839\u76EE\u5F55 AGENTS.md\uFF08\u5B8C\u6574\u5904\u7406\uFF09\n\n```markdown\n# PROJECT KNOWLEDGE BASE\n\n**\u751F\u6210\u65F6\u95F4\uFF1A** {TIMESTAMP}\n**\u63D0\u4EA4\uFF1A** {SHORT_SHA}\n**\u5206\u652F\uFF1A** {BRANCH}\n\n## \u6982\u8FF0\n{1-2 \u53E5\u8BDD\uFF1A\u9879\u76EE\u5185\u5BB9 + \u6838\u5FC3\u6280\u672F\u6808}\n\n## \u7ED3\u6784\n\\`\\`\\`\n{root}/\n\u251C\u2500\u2500 {dir}/    # {\u4EC5\u975E\u663E\u800C\u6613\u89C1\u7684\u7528\u9014}\n\u2514\u2500\u2500 {entry}\n\\`\\`\\`\n\n## \u67E5\u627E\u4F4D\u7F6E\n| \u4EFB\u52A1 | \u4F4D\u7F6E | \u5907\u6CE8 |\n|------|----------|-------|\n\n## \u4EE3\u7801\u6620\u5C04\n{\u6765\u81EA LSP - \u5982\u679C\u4E0D\u53EF\u7528\u6216\u9879\u76EE <10 \u4E2A\u6587\u4EF6\u5219\u8DF3\u8FC7}\n\n| \u7B26\u53F7 | \u7C7B\u578B | \u4F4D\u7F6E | \u5F15\u7528\u6570 | \u89D2\u8272 |\n|--------|------|----------|------|------|\n\n## \u7EA6\u5B9A\n{\u4EC5\u6807\u51C6\u5B9E\u8DF5\u7684\u504F\u5DEE}\n\n## \u53CD\u6A21\u5F0F\uFF08\u672C\u9879\u76EE\uFF09\n{\u6B64\u5904\u660E\u786E\u7981\u6B62\u7684\u5185\u5BB9}\n\n## \u72EC\u7279\u98CE\u683C\n{\u9879\u76EE\u7279\u5B9A\u7684}\n\n## \u547D\u4EE4\n\\`\\`\\`bash\n{\u5F00\u53D1/\u6D4B\u8BD5/\u6784\u5EFA}\n\\`\\`\\`\n\n## \u5907\u6CE8\n{\u6CE8\u610F\u4E8B\u9879}\n```\n\n**\u8D28\u91CF\u63A7\u5236**\uFF1A50-150 \u884C\uFF0C\u65E0\u901A\u7528\u5EFA\u8BAE\uFF0C\u65E0\u663E\u800C\u6613\u89C1\u7684\u4FE1\u606F\u3002\n\n### \u5B50\u76EE\u5F55 AGENTS.md\uFF08\u5E76\u884C\uFF09\n\n\u4E3A\u6BCF\u4E2A\u4F4D\u7F6E\u542F\u52A8\u5199\u5165\u4EFB\u52A1\uFF1A\n\n```\nfor loc in AGENTS_LOCATIONS\uFF08\u6839\u76EE\u5F55\u9664\u5916\uFF09\uFF1A\n  delegate_task(category=\"writing\", prompt=\\`\n    \u4E3A\u4EE5\u4E0B\u76EE\u5F55\u751F\u6210 AGENTS.md\uFF1A${loc.path}\n    - \u539F\u56E0\uFF1A${loc.reason}\n    - \u6700\u591A 30-80 \u884C\n    - \u7EDD\u4E0D\u91CD\u590D\u7236\u76EE\u5F55\u5185\u5BB9\n    - \u7AE0\u8282\uFF1A\u6982\u8FF0\uFF081 \u884C\uFF09\u3001\u7ED3\u6784\uFF08\u5982\u679C >5 \u4E2A\u5B50\u76EE\u5F55\uFF09\u3001\u67E5\u627E\u4F4D\u7F6E\u3001\u7EA6\u5B9A\uFF08\u5982\u679C\u4E0D\u540C\uFF09\u3001\u53CD\u6A21\u5F0F\n  \\`)\n```\n\n**\u7B49\u5F85\u5168\u90E8\u5B8C\u6210\u3002\u5C06 \"generate\" \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n## \u9636\u6BB5 4\uFF1A\u5BA1\u67E5\u4E0E\u53BB\u91CD\n\n**\u5C06 \"review\" \u6807\u8BB0\u4E3A in_progress\u3002**\n\n\u5BF9\u6BCF\u4E2A\u751F\u6210\u7684\u6587\u4EF6\uFF1A\n- \u79FB\u9664\u901A\u7528\u5EFA\u8BAE\n- \u79FB\u9664\u4E0E\u7236\u76EE\u5F55\u91CD\u590D\u7684\u5185\u5BB9\n- \u7CBE\u7B80\u5230\u5927\u5C0F\u9650\u5236\n- \u9A8C\u8BC1\u7B80\u6D01\u98CE\u683C\n\n**\u5C06 \"review\" \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n## \u6700\u7EC8\u62A5\u544A\n\n```\n=== init-deep \u5B8C\u6210 ===\n\n\u6A21\u5F0F\uFF1A{update | create-new}\n\n\u6587\u4EF6\uFF1A\n  [OK] ./AGENTS.md\uFF08\u6839\u76EE\u5F55\uFF0C{N} \u884C\uFF09\n  [OK] ./src/hooks/AGENTS.md\uFF08{N} \u884C\uFF09\n\n\u5DF2\u5206\u6790\u7684\u76EE\u5F55\u6570\uFF1A{N}\n\u521B\u5EFA\u7684 AGENTS.md\uFF1A{N}\n\u66F4\u65B0\u7684 AGENTS.md\uFF1A{N}\n\n\u5C42\u6B21\u7ED3\u6784\uFF1A\n  ./AGENTS.md\n  \u2514\u2500\u2500 src/hooks/AGENTS.md\n```\n\n---\n\n## \u53CD\u6A21\u5F0F\n\n- **\u9759\u6001\u4EE3\u7406\u6570\u91CF**\uFF1A\u5FC5\u987B\u6839\u636E\u9879\u76EE\u5927\u5C0F/\u6DF1\u5EA6\u53D8\u5316\u4EE3\u7406\u6570\u91CF\n- **\u987A\u5E8F\u6267\u884C**\uFF1A\u5FC5\u987B\u5E76\u884C\uFF08explore + LSP \u5E76\u53D1\uFF09\n- **\u5FFD\u7565\u73B0\u6709\u6587\u4EF6**\uFF1A\u59CB\u7EC8\u5148\u8BFB\u53D6\u73B0\u6709\u6587\u4EF6\uFF0C\u5373\u4F7F\u4F7F\u7528 --create-new\n- **\u8FC7\u5EA6\u6587\u6863\u5316**\uFF1A\u5E76\u975E\u6BCF\u4E2A\u76EE\u5F55\u90FD\u9700\u8981 AGENTS.md\n- **\u5197\u4F59**\uFF1A\u5B50\u76EE\u5F55\u7EDD\u4E0D\u91CD\u590D\u7236\u76EE\u5F55\u5185\u5BB9\n- **\u901A\u7528\u5185\u5BB9**\uFF1A\u79FB\u9664\u9002\u7528\u4E8E\u6240\u6709\u9879\u76EE\u7684\u5185\u5BB9\n- **\u5197\u957F\u98CE\u683C**\uFF1A\u7B80\u6D01\u81F3\u4E0A\uFF0C\u5426\u5219\u5C31\u662F\u5931\u8D25";

package/dist/features/builtin-commands/templates/ralph-loop.d.ts

@@ -1,3 +1,2 @@
-export declare const RALPH_LOOP_TEMPLATE = "\u4F60\u6B63\u5728\u542F\u52A8 Ralph \u5FAA\u73AF\u2014\u2014\u4E00\u4E2A\u81EA\u5F15\u7528\u7684\u5F00\u53D1\u5FAA\u73AF\uFF0C\u5C06\u6301\u7EED\u8FD0\u884C\u76F4\u5230\u4EFB\u52A1\u5B8C\u6210\u3002\n\n## Ralph \u5FAA\u73AF\u5DE5\u4F5C\u539F\u7406\n\n1. \u4F60\u5C06\u6301\u7EED\u5904\u7406\u4EFB\u52A1\n2. \u5F53\u4F60\u8BA4\u4E3A\u4EFB\u52A1\u5B8C\u5168\u5B8C\u6210\u65F6\uFF0C\u8F93\u51FA\uFF1A`<promise>{{COMPLETION_PROMISE}}</promise>`\n3. \u5982\u679C\u4F60\u672A\u8F93\u51FA\u627F\u8BFA\u6807\u7B7E\uFF0C\u5FAA\u73AF\u5C06\u81EA\u52A8\u6CE8\u5165\u53E6\u4E00\u4E2A\u63D0\u793A\u4EE5\u7EE7\u7EED\n4. \u6700\u5927\u8FED\u4EE3\u6B21\u6570\uFF1A\u53EF\u914D\u7F6E\uFF08\u9ED8\u8BA4 100\uFF09\n\n## \u89C4\u5219\n\n- \u4E13\u6CE8\u4E8E\u5B8C\u5168\u5B8C\u6210\u4EFB\u52A1\uFF0C\u800C\u975E\u90E8\u5206\u5B8C\u6210\n- \u5728\u4EFB\u52A1\u771F\u6B63\u5B8C\u6210\u4E4B\u524D\u4E0D\u8981\u8F93\u51FA\u5B8C\u6210\u627F\u8BFA\n- \u6BCF\u6B21\u8FED\u4EE3\u5E94\u671D\u7740\u76EE\u6807\u53D6\u5F97\u6709\u610F\u4E49\u7684\u8FDB\u5C55\n- \u5982\u679C\u9047\u5230\u56F0\u96BE\uFF0C\u5C1D\u8BD5\u4E0D\u540C\u7684\u65B9\u6CD5\n- \u4F7F\u7528\u5F85\u529E\u4E8B\u9879\u8FFD\u8E2A\u8FDB\u5EA6\n\n## \u9000\u51FA\u6761\u4EF6\n\n1. **\u5B8C\u6210**\uFF1A\u5B8C\u5168\u5B8C\u6210\u540E\u8F93\u51FA\u5B8C\u6210\u627F\u8BFA\u6807\u7B7E\n2. **\u6700\u5927\u8FED\u4EE3\u6B21\u6570**\uFF1A\u5FAA\u73AF\u5728\u8FBE\u5230\u9650\u5236\u65F6\u81EA\u52A8\u505C\u6B62\n3. **\u53D6\u6D88**\uFF1A\u7528\u6237\u8FD0\u884C `/cancel-ralph` \u547D\u4EE4\n\n## \u4F60\u7684\u4EFB\u52A1\n\n\u89E3\u6790\u4EE5\u4E0B\u53C2\u6570\u5E76\u5F00\u59CB\u5904\u7406\u4EFB\u52A1\u3002\u683C\u5F0F\u4E3A\uFF1A\n`\"task description\" [--completion-promise=TEXT] [--max-iterations=N] [--strategy=reset|continue]`\n\n\u9ED8\u8BA4\u5B8C\u6210\u627F\u8BFA\u4E3A \"DONE\"\uFF0C\u9ED8\u8BA4\u6700\u5927\u8FED\u4EE3\u6B21\u6570\u4E3A 100\u3002";
-export declare const ULW_LOOP_TEMPLATE = "\u4F60\u6B63\u5728\u542F\u52A8 ULTRAWORK \u5FAA\u73AF\u2014\u2014\u4E00\u4E2A\u81EA\u5F15\u7528\u7684\u5F00\u53D1\u5FAA\u73AF\uFF0C\u5C06\u6301\u7EED\u8FD0\u884C\u76F4\u5230\u9A8C\u8BC1\u5B8C\u6210\u3002\n\n## ULTRAWORK \u5FAA\u73AF\u5DE5\u4F5C\u539F\u7406\n\n1. \u4F60\u5C06\u6301\u7EED\u5904\u7406\u4EFB\u52A1\n2. \u5F53\u4F60\u8BA4\u4E3A\u5DE5\u4F5C\u5B8C\u6210\u65F6\uFF0C\u8F93\u51FA\uFF1A`<promise>{{COMPLETION_PROMISE}}</promise>`\n3. \u8FD9\u5E76\u4E0D\u4F1A\u7ED3\u675F\u5FAA\u73AF\u3002\u7CFB\u7EDF\u5C06\u8981\u6C42 Oracle \u8FDB\u884C\u9A8C\u8BC1\n4. \u53EA\u6709\u5F53\u7CFB\u7EDF\u786E\u8BA4 Oracle \u9A8C\u8BC1\u901A\u8FC7\u540E\uFF0C\u5FAA\u73AF\u624D\u4F1A\u7ED3\u675F\n5. \u8D85\u9AD8\u6548\u6A21\u5F0F\u7684\u6700\u5927\u8FED\u4EE3\u6B21\u6570\u4E3A 500\uFF0C\u666E\u901A\u6A21\u5F0F\u4E3A 100\n\n## \u89C4\u5219\n\n- \u4E13\u6CE8\u4E8E\u5B8C\u5168\u5B8C\u6210\u4EFB\u52A1\n- \u5728\u8F93\u51FA\u5B8C\u6210\u627F\u8BFA\u540E\uFF0C\u6309\u7167\u6307\u793A\u8FD0\u884C Oracle \u9A8C\u8BC1\n- \u5728 Oracle \u9A8C\u8BC1\u901A\u8FC7\u4E4B\u524D\uFF0C\u4E0D\u8981\u5C06 DONE \u89C6\u4E3A\u6700\u7EC8\u5B8C\u6210\n\n## \u9000\u51FA\u6761\u4EF6\n\n1. **\u9A8C\u8BC1\u901A\u8FC7**\uFF1AOracle \u9A8C\u8BC1\u7ED3\u679C\u4E14\u7CFB\u7EDF\u786E\u8BA4\u901A\u8FC7\n2. **\u53D6\u6D88**\uFF1A\u7528\u6237\u8FD0\u884C `/cancel-ralph`\n\n## \u4F60\u7684\u4EFB\u52A1\n\n\u89E3\u6790\u4EE5\u4E0B\u53C2\u6570\u5E76\u5F00\u59CB\u5904\u7406\u4EFB\u52A1\u3002\u683C\u5F0F\u4E3A\uFF1A\n`\"task description\" [--completion-promise=TEXT] [--strategy=reset|continue]`\n\n\u9ED8\u8BA4\u5B8C\u6210\u627F\u8BFA\u4E3A \"DONE\"\u3002";
-export declare const CANCEL_RALPH_TEMPLATE = "\u53D6\u6D88\u5F53\u524D\u6D3B\u52A8\u7684 Ralph \u5FAA\u73AF\u3002\n\n\u8FD9\u5C06\uFF1A\n1. \u505C\u6B62\u5FAA\u73AF\u7EE7\u7EED\u8FD0\u884C\n2. \u6E05\u9664\u5FAA\u73AF\u72B6\u6001\u6587\u4EF6\n3. \u5141\u8BB8\u4F1A\u8BDD\u6B63\u5E38\u7ED3\u675F\n\n\u68C0\u67E5\u5FAA\u73AF\u662F\u5426\u5904\u4E8E\u6D3B\u52A8\u72B6\u6001\u5E76\u53D6\u6D88\u5B83\u3002\u544A\u77E5\u7528\u6237\u7ED3\u679C\u3002";
+export declare const RALPH_LOOP_TEMPLATE = "\u4F60\u6B63\u5728\u5F00\u59CB\u4E00\u4E2A Ralph Loop\u2014\u2014\u4E00\u4E2A\u81EA\u6211\u5F15\u7528\u7684\u5F00\u53D1\u5FAA\u73AF\uFF0C\u6301\u7EED\u8FD0\u884C\u76F4\u5230\u4EFB\u52A1\u5B8C\u6210\u3002\n\n## Ralph Loop \u7684\u5DE5\u4F5C\u539F\u7406\n\n1. \u4F60\u5C06\u6301\u7EED\u5904\u7406\u4EFB\u52A1\n2. \u5F53\u4F60\u8BA4\u4E3A\u4EFB\u52A1\u5B8C\u5168\u5B8C\u6210\u65F6\uFF0C\u8F93\u51FA\uFF1A`<promise>{{COMPLETION_PROMISE}}</promise>`\n3. \u5982\u679C\u4F60\u6CA1\u6709\u8F93\u51FA\u627F\u8BFA\u6807\u8BB0\uFF0C\u5FAA\u73AF\u5C06\u81EA\u52A8\u6CE8\u5165\u53E6\u4E00\u4E2A\u63D0\u793A\u4EE5\u7EE7\u7EED\n4. \u6700\u5927\u8FED\u4EE3\u6B21\u6570\uFF1A\u53EF\u914D\u7F6E\uFF08\u9ED8\u8BA4 100\uFF09\n\n## \u89C4\u5219\n\n- \u4E13\u6CE8\u4E8E\u5B8C\u5168\u5B8C\u6210\u4EFB\u52A1\uFF0C\u800C\u4E0D\u662F\u90E8\u5206\u5B8C\u6210\n- \u5728\u4EFB\u52A1\u771F\u6B63\u5B8C\u6210\u4E4B\u524D\u4E0D\u8981\u8F93\u51FA\u5B8C\u6210\u627F\u8BFA\n- \u6BCF\u6B21\u8FED\u4EE3\u90FD\u5E94\u671D\u7740\u76EE\u6807\u53D6\u5F97\u6709\u610F\u4E49\u7684\u8FDB\u5C55\n- \u5982\u679C\u5361\u4F4F\u4E86\uFF0C\u5C1D\u8BD5\u4E0D\u540C\u7684\u65B9\u6CD5\n- \u4F7F\u7528 todos \u6765\u8DDF\u8E2A\u4F60\u7684\u8FDB\u5EA6\n\n## \u9000\u51FA\u6761\u4EF6\n\n1. **\u5B8C\u6210**\uFF1A\u5B8C\u5168\u5B8C\u6210\u540E\u8F93\u51FA\u4F60\u7684\u5B8C\u6210\u627F\u8BFA\u6807\u7B7E\n2. **\u6700\u5927\u8FED\u4EE3\u6B21\u6570**\uFF1A\u5FAA\u73AF\u5728\u8FBE\u5230\u9650\u5236\u65F6\u81EA\u52A8\u505C\u6B62\n3. **\u53D6\u6D88**\uFF1A\u7528\u6237\u8FD0\u884C `/cancel-ralph` \u547D\u4EE4\n\n## \u4F60\u7684\u4EFB\u52A1\n\n\u89E3\u6790\u4E0B\u9762\u7684\u53C2\u6570\u5E76\u5F00\u59CB\u5904\u7406\u4EFB\u52A1\u3002\u683C\u5F0F\u5982\u4E0B\uFF1A\n`\"\u4EFB\u52A1\u63CF\u8FF0\" [--completion-promise=\u6587\u672C] [--max-iterations=N]`\n\n\u9ED8\u8BA4\u5B8C\u6210\u627F\u8BFA\u662F \"DONE\"\uFF0C\u9ED8\u8BA4\u6700\u5927\u8FED\u4EE3\u6B21\u6570\u662F 100\u3002";
+export declare const CANCEL_RALPH_TEMPLATE = "\u53D6\u6D88\u5F53\u524D\u6D3B\u8DC3\u7684 Ralph Loop\u3002\n\n\u8FD9\u5C06\uFF1A\n1. \u505C\u6B62\u5FAA\u73AF\u7EE7\u7EED\u8FD0\u884C\n2. \u6E05\u9664\u5FAA\u73AF\u72B6\u6001\u6587\u4EF6\n3. \u5141\u8BB8\u4F1A\u8BDD\u6B63\u5E38\u7ED3\u675F\n\n\u68C0\u67E5\u662F\u5426\u6709\u6D3B\u8DC3\u7684\u5FAA\u73AF\u5E76\u53D6\u6D88\u5B83\u3002\u5C06\u7ED3\u679C\u544A\u77E5\u7528\u6237\u3002";

package/dist/features/builtin-commands/templates/refactor.d.ts

@@ -1 +1 @@
-export declare const REFACTOR_TEMPLATE = "# \u667A\u80FD\u91CD\u6784\u547D\u4EE4\n\n## \u4F7F\u7528\u65B9\u6CD5\n```\n/refactor <refactoring-target> [--scope=<file|module|project>] [--strategy=<safe|aggressive>]\n\nArguments:\n  refactoring-target: \u8981\u91CD\u6784\u7684\u5BF9\u8C61\u3002\u53EF\u4EE5\u662F\uFF1A\n    - \u6587\u4EF6\u8DEF\u5F84\uFF1Asrc/auth/handler.ts\n    - \u7B26\u53F7\u540D\u79F0\uFF1A\"AuthService class\"\n    - \u6A21\u5F0F\uFF1A \"\u6240\u6709\u4F7F\u7528\u5DF2\u5F03\u7528API\u7684\u51FD\u6570\"\n    - \u63CF\u8FF0\uFF1A \"\u5C06\u9A8C\u8BC1\u903B\u8F91\u63D0\u53D6\u5230\u72EC\u7ACB\u6A21\u5757\"\n\nOptions:\n  --scope: \u91CD\u6784\u8303\u56F4\uFF08\u9ED8\u8BA4\uFF1Amodule\uFF09\n    - file\uFF1A\u4EC5\u5355\u4E2A\u6587\u4EF6\n    - module\uFF1A\u6A21\u5757/\u76EE\u5F55\u8303\u56F4\n    - project\uFF1A\u6574\u4E2A\u4EE3\u7801\u5E93\n\n  --strategy: \u98CE\u9669\u627F\u53D7\u5EA6\uFF08\u9ED8\u8BA4\uFF1Asafe\uFF09\n    - safe\uFF1A\u4FDD\u5B88\uFF0C\u9700\u8981\u6700\u5927\u6D4B\u8BD5\u8986\u76D6\u7387\n    - aggressive\uFF1A\u5141\u8BB8\u5728\u5145\u5206\u8986\u76D6\u7684\u60C5\u51B5\u4E0B\u8FDB\u884C\u66F4\u5927\u8303\u56F4\u66F4\u6539\n```\n\n## \u6B64\u547D\u4EE4\u7684\u529F\u80FD\n\n\u6267\u884C\u667A\u80FD\u3001\u786E\u5B9A\u6027\u7684\u91CD\u6784\uFF0C\u5177\u6709\u5B8C\u6574\u7684\u4EE3\u7801\u5E93\u611F\u77E5\u80FD\u529B\u3002\u4E0E\u76F2\u76EE\u7684\u641C\u7D22\u66FF\u6362\u4E0D\u540C\uFF0C\u6B64\u547D\u4EE4\uFF1A\n\n1. **\u7406\u89E3\u4F60\u7684\u610F\u56FE** - \u5206\u6790\u4F60\u5B9E\u9645\u60F3\u8981\u5B9E\u73B0\u7684\u76EE\u6807\n2. **\u6620\u5C04\u4EE3\u7801\u5E93** - \u5728\u89E6\u78B0\u4EFB\u4F55\u4EE3\u7801\u4E4B\u524D\u6784\u5EFA\u786E\u5B9A\u6027\u7684\u4EE3\u7801\u6620\u5C04\n3. **\u8BC4\u4F30\u98CE\u9669** - \u8BC4\u4F30\u6D4B\u8BD5\u8986\u76D6\u7387\u5E76\u786E\u5B9A\u9A8C\u8BC1\u7B56\u7565\n4. **\u7CBE\u5FC3\u89C4\u5212** - \u4F7F\u7528\u89C4\u5212\u4EE3\u7406\u521B\u5EFA\u8BE6\u7EC6\u8BA1\u5212\n5. **\u7CBE\u786E\u6267\u884C** - \u4F7F\u7528 LSP \u548C AST-grep \u8FDB\u884C\u9010\u6B65\u91CD\u6784\n6. **\u6301\u7EED\u9A8C\u8BC1** - \u6BCF\u6B21\u66F4\u6539\u540E\u8FD0\u884C\u6D4B\u8BD5\u4EE5\u786E\u4FDD\u96F6\u56DE\u5F52\n\n---\n\n# \u9636\u6BB5 0\uFF1A\u610F\u56FE\u68C0\u67E5\uFF08\u5F3A\u5236\u7B2C\u4E00\u6B65\uFF09\n\n**\u5728\u4EFB\u4F55\u64CD\u4F5C\u4E4B\u524D\uFF0C\u5BF9\u8BF7\u6C42\u8FDB\u884C\u5206\u7C7B\u548C\u9A8C\u8BC1\u3002**\n\n## \u6B65\u9AA4 0.1\uFF1A\u89E3\u6790\u8BF7\u6C42\u7C7B\u578B\n\n| \u4FE1\u53F7 | \u5206\u7C7B | \u64CD\u4F5C |\n|--------|----------------|--------|\n| \u7279\u5B9A\u6587\u4EF6/\u7B26\u53F7 | \u663E\u5F0F | \u8FDB\u5165\u4EE3\u7801\u5E93\u5206\u6790 |\n| \"\u5C06 X \u91CD\u6784\u4E3A Y\" | \u660E\u786E\u8F6C\u6362 | \u8FDB\u5165\u4EE3\u7801\u5E93\u5206\u6790 |\n| \"\u6539\u8FDB\"\u3001\"\u6E05\u7406\" | \u6A21\u7CCA\u4E0D\u6E05 | **\u5FC5\u987B\u8BE2\u95EE**\uFF1A\"\u9700\u8981\u4EC0\u4E48\u5177\u4F53\u6539\u8FDB\uFF1F\" |\n| \u8303\u56F4\u4E0D\u660E\u786E | \u4E0D\u786E\u5B9A | **\u5FC5\u987B\u8BE2\u95EE**\uFF1A\"\u6D89\u53CA\u54EA\u4E9B\u6A21\u5757/\u6587\u4EF6\uFF1F\" |\n| \u7F3A\u5C11\u4E0A\u4E0B\u6587 | \u4E0D\u5B8C\u6574 | **\u5FC5\u987B\u8BE2\u95EE**\uFF1A\"\u671F\u671B\u7684\u7ED3\u679C\u662F\u4EC0\u4E48\uFF1F\" |\n\n## \u6B65\u9AA4 0.2\uFF1A\u9A8C\u8BC1\u7406\u89E3\n\n\u5728\u7EE7\u7EED\u4E4B\u524D\uFF0C\u786E\u8BA4\uFF1A\n- [ ] \u76EE\u6807\u5DF2\u660E\u786E\u8BC6\u522B\n- [ ] \u671F\u671B\u7ED3\u679C\u5DF2\u7406\u89E3\n- [ ] \u8303\u56F4\u5DF2\u5B9A\u4E49\uFF08\u6587\u4EF6/\u6A21\u5757/\u9879\u76EE\uFF09\n- [ ] \u6210\u529F\u6807\u51C6\u53EF\u63CF\u8FF0\n\n**\u5982\u679C\u4EE5\u4E0A\u4EFB\u4F55\u4E00\u9879\u4E0D\u660E\u786E\uFF0C\u8BF7\u63D0\u51FA\u6F84\u6E05\u95EE\u9898\uFF1A**\n\n```\nI want to make sure I understand the refactoring goal correctly.\n\n**What I understood**: [interpretation]\n**What I'm unsure about**: [specific ambiguity]\n\nOptions I see:\n1. [Option A] - [implications]\n2. [Option B] - [implications]\n\n**My recommendation**: [suggestion with reasoning]\n\nShould I proceed with [recommendation], or would you prefer differently?\n```\n\n## \u6B65\u9AA4 0.3\uFF1A\u521B\u5EFA\u521D\u59CB\u5F85\u529E\u4E8B\u9879\n\n**\u5728\u7406\u89E3\u8BF7\u6C42\u540E\u7ACB\u5373\u521B\u5EFA\u5F85\u529E\u4E8B\u9879\uFF1A**\n\n```\nTodoWrite([\n  {\"id\": \"phase-1\", \"content\": \"PHASE 1: Codebase Analysis - launch parallel explore agents\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-2\", \"content\": \"PHASE 2: Build Codemap - map dependencies and impact zones\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-3\", \"content\": \"PHASE 3: Test Assessment - analyze test coverage and verification strategy\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-4\", \"content\": \"PHASE 4: Plan Generation - invoke Plan agent for detailed refactoring plan\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-5\", \"content\": \"PHASE 5: Execute Refactoring - step-by-step with continuous verification\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-6\", \"content\": \"PHASE 6: Final Verification - full test suite and regression check\", \"status\": \"pending\", \"priority\": \"high\"}\n])\n```\n\n---\n\n# \u9636\u6BB5 1\uFF1A\u4EE3\u7801\u5E93\u5206\u6790\uFF08\u5E76\u884C\u63A2\u7D22\uFF09\n\n**\u5C06 phase-1 \u6807\u8BB0\u4E3A in_progress\u3002**\n\n## 1.1\uFF1A\u542F\u52A8\u5E76\u884C\u63A2\u7D22\u4EE3\u7406\uFF08\u540E\u53F0\uFF09\n\n\u4F7F\u7528 `call_omo_agent` \u540C\u65F6\u89E6\u53D1\u6240\u6709\u4EE5\u4E0B\u4EE3\u7406\uFF1A\n\n```\n// Agent 1: Find the refactoring target\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find all occurrences and definitions of [TARGET]. \n  Report: file paths, line numbers, usage patterns.\"\n)\n\n// Agent 2: Find related code\ncall_omo_agent(\n  subagent_type=\"explore\", \n  run_in_background=true,\n  prompt=\"Find all code that imports, uses, or depends on [TARGET].\n  Report: dependency chains, import graphs.\"\n)\n\n// Agent 3: Find similar patterns\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find similar code patterns to [TARGET] in the codebase.\n  Report: analogous implementations, established conventions.\"\n)\n\n// Agent 4: Find tests\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find all test files related to [TARGET].\n  Report: test file paths, test case names, coverage indicators.\"\n)\n\n// Agent 5: Architecture context\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find architectural patterns and module organization around [TARGET].\n  Report: module boundaries, layer structure, design patterns in use.\"\n)\n```\n\n## 1.2\uFF1A\u76F4\u63A5\u5DE5\u5177\u63A2\u7D22\uFF08\u5728\u4EE3\u7406\u8FD0\u884C\u65F6\uFF09\n\n\u5728\u540E\u53F0\u4EE3\u7406\u8FD0\u884C\u65F6\uFF0C\u4F7F\u7528\u76F4\u63A5\u5DE5\u5177\uFF1A\n\n### LSP \u5DE5\u5177\u7528\u4E8E\u7CBE\u786E\u5206\u6790\uFF1A\n\n```typescript\n// Find definition(s)\nLspGotoDefinition(filePath, line, character)  // Where is it defined?\n\n// Find ALL usages across workspace\nLspFindReferences(filePath, line, character, includeDeclaration=true)\n\n// Get file structure\nLspDocumentSymbols(filePath)  // Hierarchical outline\nLspWorkspaceSymbols(filePath, query=\"[target_symbol]\")  // Search by name\n\n// Get current diagnostics\nlsp_diagnostics(filePath)  // Errors, warnings before we start\n```\n\n### AST-Grep \u7528\u4E8E\u6A21\u5F0F\u5206\u6790\uFF1A\n\n```typescript\n// Find structural patterns\nast_grep_search(\n  pattern=\"function $NAME($$$) { $$$ }\",  // or relevant pattern\n  lang=\"typescript\",  // or relevant language\n  paths=[\"src/\"]\n)\n\n// Preview refactoring (DRY RUN)\nast_grep_replace(\n  pattern=\"[old_pattern]\",\n  rewrite=\"[new_pattern]\",\n  lang=\"[language]\",\n  dryRun=true  // ALWAYS preview first\n)\n```\n\n### Grep \u7528\u4E8E\u6587\u672C\u6A21\u5F0F\u641C\u7D22\uFF1A\n\n```\ngrep(pattern=\"[search_term]\", path=\"src/\", include=\"*.ts\")\n```\n\n## 1.3\uFF1A\u6536\u96C6\u540E\u53F0\u7ED3\u679C\n\n```\nbackground_output(task_id=\"[agent_1_id]\")\nbackground_output(task_id=\"[agent_2_id]\")\n...\n```\n\n**\u6536\u96C6\u6240\u6709\u7ED3\u679C\u540E\uFF0C\u5C06 phase-1 \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n# \u9636\u6BB5 2\uFF1A\u6784\u5EFA\u4EE3\u7801\u6620\u5C04\uFF08\u4F9D\u8D56\u6620\u5C04\uFF09\n\n**\u5C06 phase-2 \u6807\u8BB0\u4E3A in_progress\u3002**\n\n## 2.1\uFF1A\u6784\u5EFA\u786E\u5B9A\u6027\u4EE3\u7801\u6620\u5C04\n\n\u57FA\u4E8E\u9636\u6BB5 1 \u7684\u7ED3\u679C\u6784\u5EFA\uFF1A\n\n```\n## CODEMAP: [TARGET]\n\n### Core Files (Direct Impact)\n- `path/to/file.ts:L10-L50` - Primary definition\n- `path/to/file2.ts:L25` - Key usage\n\n### Dependency Graph\n```\n[TARGET] \n\u251C\u2500\u2500 imports from: \n\u2502   \u251C\u2500\u2500 module-a (types)\n\u2502   \u2514\u2500\u2500 module-b (utils)\n\u251C\u2500\u2500 imported by:\n\u2502   \u251C\u2500\u2500 consumer-1.ts\n\u2502   \u251C\u2500\u2500 consumer-2.ts\n\u2502   \u2514\u2500\u2500 consumer-3.ts\n\u2514\u2500\u2500 used by:\n    \u251C\u2500\u2500 handler.ts (direct call)\n    \u2514\u2500\u2500 service.ts (dependency injection)\n```\n\n### Impact Zones\n| \u533A\u57DF | \u98CE\u9669\u7B49\u7EA7 | \u53D7\u5F71\u54CD\u6587\u4EF6 | \u6D4B\u8BD5\u8986\u76D6\u7387 |\n|------|------------|----------------|---------------|\n| \u6838\u5FC3 | \u9AD8 | 3 \u4E2A\u6587\u4EF6 | 85% \u5DF2\u8986\u76D6 |\n| \u6D88\u8D39\u8005 | \u4E2D | 8 \u4E2A\u6587\u4EF6 | 70% \u5DF2\u8986\u76D6 |\n| \u8FB9\u7F18 | \u4F4E | 2 \u4E2A\u6587\u4EF6 | 50% \u5DF2\u8986\u76D6 |\n\n### \u5DF2\u6709\u6A21\u5F0F\n- \u6A21\u5F0F A\uFF1A[\u63CF\u8FF0] - \u5728 N \u5904\u4F7F\u7528\n- \u6A21\u5F0F B\uFF1A[\u63CF\u8FF0] - \u5DF2\u5EFA\u7ACB\u7684\u7EA6\u5B9A\n```\n\n## 2.2\uFF1A\u8BC6\u522B\u91CD\u6784\u7EA6\u675F\n\n\u57FA\u4E8E\u4EE3\u7801\u6620\u5C04\uFF1A\n- **\u5FC5\u987B\u9075\u5FAA**\uFF1A[\u5DF2\u8BC6\u522B\u7684\u73B0\u6709\u6A21\u5F0F]\n- **\u4E0D\u80FD\u7834\u574F**\uFF1A[\u5173\u952E\u4F9D\u8D56]\n- **\u53EF\u5B89\u5168\u66F4\u6539**\uFF1A[\u9694\u79BB\u7684\u4EE3\u7801\u533A\u57DF]\n- **\u9700\u8981\u8FC1\u79FB**\uFF1A[\u7834\u574F\u6027\u53D8\u66F4\u7684\u5F71\u54CD]\n\n**\u5C06 phase-2 \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n# \u9636\u6BB5 3\uFF1A\u6D4B\u8BD5\u8BC4\u4F30\uFF08\u9A8C\u8BC1\u7B56\u7565\uFF09\n\n**\u5C06 phase-3 \u6807\u8BB0\u4E3A in_progress\u3002**\n\n## 3.1\uFF1A\u68C0\u6D4B\u6D4B\u8BD5\u57FA\u7840\u8BBE\u65BD\n\n```bash\n# Check for test commands\ncat package.json | jq '.scripts | keys[] | select(test(\"test\"))'\n\n# Or for Python\nls -la pytest.ini pyproject.toml setup.cfg\n\n# Or for Go\nls -la *_test.go\n```\n\n## 3.2\uFF1A\u5206\u6790\u6D4B\u8BD5\u8986\u76D6\u7387\n\n```\n// Find all tests related to target\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=false,  // Need this synchronously\n  prompt=\"Analyze test coverage for [TARGET]:\n  1. Which test files cover this code?\n  2. What test cases exist?\n  3. Are there integration tests?\n  4. What edge cases are tested?\n  5. Estimated coverage percentage?\"\n)\n```\n\n## 3.3\uFF1A\u786E\u5B9A\u9A8C\u8BC1\u7B56\u7565\n\n\u57FA\u4E8E\u6D4B\u8BD5\u5206\u6790\uFF1A\n\n| \u8986\u76D6\u7387\u7B49\u7EA7 | \u7B56\u7565 |\n|----------------|----------|\n| \u9AD8\uFF08>80%\uFF09 | \u6BCF\u4E00\u6B65\u540E\u8FD0\u884C\u73B0\u6709\u6D4B\u8BD5 |\n| \u4E2D\uFF0850-80%\uFF09 | \u8FD0\u884C\u6D4B\u8BD5 + \u6DFB\u52A0\u5B89\u5168\u65AD\u8A00 |\n| \u4F4E\uFF08<50%\uFF09 | **\u6682\u505C**\uFF1A\u5EFA\u8BAE\u5148\u6DFB\u52A0\u6D4B\u8BD5 |\n| \u65E0 | **\u963B\u6B62**\uFF1A\u62D2\u7EDD\u6FC0\u8FDB\u91CD\u6784 |\n\n**\u5982\u679C\u8986\u76D6\u7387\u4E3A\u4F4E\u6216\u65E0\uFF0C\u8BE2\u95EE\u7528\u6237\uFF1A**\n\n```\nTest coverage for [TARGET] is [LEVEL].\n\n**Risk Assessment**: Refactoring without adequate tests is dangerous.\n\nOptions:\n1. Add tests first, then refactor (RECOMMENDED)\n2. Proceed with extra caution, manual verification required\n3. Abort refactoring\n\nWhich approach do you prefer?\n```\n\n## 3.4\uFF1A\u8BB0\u5F55\u9A8C\u8BC1\u8BA1\u5212\n\n```\n## VERIFICATION PLAN\n\n### Test Commands\n- Unit: `bun test` / `npm test` / `pytest` / etc.\n- Integration: [command if exists]\n- Type check: `tsc --noEmit` / `pyright` / etc.\n\n### Verification Checkpoints\nAfter each refactoring step:\n1. lsp_diagnostics \u2192 zero new errors\n2. Run test command \u2192 all pass\n3. Type check \u2192 clean\n\n### Regression Indicators\n- [Specific test that must pass]\n- [Behavior that must be preserved]\n- [API contract that must not change]\n```\n\n**\u5C06 phase-3 \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n# \u9636\u6BB5 4\uFF1A\u8BA1\u5212\u751F\u6210\uFF08\u89C4\u5212\u4EE3\u7406\uFF09\n\n**\u5C06 phase-4 \u6807\u8BB0\u4E3A in_progress\u3002**\n\n## 4.1\uFF1A\u8C03\u7528\u89C4\u5212\u4EE3\u7406\n\n```\nTask(\n  subagent_type=\"plan\",\n  prompt=\"Create a detailed refactoring plan:\n\n  ## Refactoring Goal\n  [User's original request]\n\n  ## Codemap (from Phase 2)\n  [Insert codemap here]\n\n  ## Test Coverage (from Phase 3)\n  [Insert verification plan here]\n\n  ## Constraints\n  - MUST follow existing patterns: [list]\n  - MUST NOT break: [critical paths]\n  - MUST run tests after each step\n\n  ## Requirements\n  1. Break down into atomic refactoring steps\n  2. Each step must be independently verifiable\n  3. Order steps by dependency (what must happen first)\n  4. Specify exact files and line ranges for each step\n  5. Include rollback strategy for each step\n  6. Define commit checkpoints\"\n)\n```\n\n## 4.2\uFF1A\u5BA1\u67E5\u548C\u9A8C\u8BC1\u8BA1\u5212\n\nAfter receiving plan from Plan agent:\n\n1. **Verify completeness**: All identified files addressed?\n2. **Verify safety**: Each step reversible?\n3. **Verify order**: Dependencies respected?\n4. **Verify verification**: Test commands specified?\n\n## 4.3\uFF1A\u6CE8\u518C\u8BE6\u7EC6\u5F85\u529E\u4E8B\u9879\n\nConvert Plan agent output into granular todos:\n\n```\nTodoWrite([\n  // Each step from the plan becomes a todo\n  {\"id\": \"refactor-1\", \"content\": \"Step 1: [description]\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"verify-1\", \"content\": \"Verify Step 1: run tests\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"refactor-2\", \"content\": \"Step 2: [description]\", \"status\": \"pending\", \"priority\": \"medium\"},\n  {\"id\": \"verify-2\", \"content\": \"Verify Step 2: run tests\", \"status\": \"pending\", \"priority\": \"medium\"},\n  // ... continue for all steps\n])\n```\n\n**\u5C06 phase-4 \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n# \u9636\u6BB5 5\uFF1A\u6267\u884C\u91CD\u6784\uFF08\u786E\u5B9A\u6027\u6267\u884C\uFF09\n\n**\u5C06 phase-5 \u6807\u8BB0\u4E3A in_progress\u3002**\n\n## 5.1\uFF1A\u6267\u884C\u534F\u8BAE\n\n\u5BF9\u6BCF\u4E2A\u91CD\u6784\u6B65\u9AA4\uFF1A\n\n### \u6B65\u9AA4\u524D\n1. Mark step todo as `in_progress`\n2. Read current file state\n3. Verify lsp_diagnostics is baseline\n\n### \u6267\u884C\u6B65\u9AA4\n\u4F7F\u7528\u9002\u5F53\u7684\u5DE5\u5177\uFF1A\n\n**\u5BF9\u4E8E\u7B26\u53F7\u91CD\u547D\u540D\uFF1A**\n```typescript\nlsp_prepare_rename(filePath, line, character)  // Validate rename is possible\nlsp_rename(filePath, line, character, newName)  // Execute rename\n```\n\n**\u5BF9\u4E8E\u6A21\u5F0F\u8F6C\u6362\uFF1A**\n```typescript\n// Preview first\nast_grep_replace(pattern, rewrite, lang, dryRun=true)\n\n// If preview looks good, execute\nast_grep_replace(pattern, rewrite, lang, dryRun=false)\n```\n\n**\u5BF9\u4E8E\u7ED3\u6784\u6027\u66F4\u6539\uFF1A**\n```typescript\n// Use Edit tool for precise changes\nedit(filePath, oldString, newString)\n```\n\n### \u6B65\u9AA4\u540E\u9A8C\u8BC1\uFF08\u5F3A\u5236\uFF09\n\n```typescript\n// 1. Check diagnostics\nlsp_diagnostics(filePath)  // Must be clean or same as baseline\n\n// 2. Run tests\nbash(\"bun test\")  // Or appropriate test command\n\n// 3. Type check\nbash(\"tsc --noEmit\")  // Or appropriate type check\n```\n\n### \u6B65\u9AA4\u5B8C\u6210\n1. \u5982\u679C\u9A8C\u8BC1\u901A\u8FC7 \u2192 \u5C06\u6B65\u9AA4\u5F85\u529E\u6807\u8BB0\u4E3A `completed`\n2. \u5982\u679C\u9A8C\u8BC1\u5931\u8D25 \u2192 **\u505C\u6B62\u5E76\u4FEE\u590D**\n\n## 5.2\uFF1A\u5931\u8D25\u6062\u590D\u534F\u8BAE\n\n\u5982\u679C\u4EFB\u4F55\u9A8C\u8BC1\u5931\u8D25\uFF1A\n\n1. **\u7ACB\u5373\u505C\u6B62**\n2. **\u56DE\u9000**\u5931\u8D25\u7684\u66F4\u6539\n3. **\u8BCA\u65AD**\u51FA\u9519\u539F\u56E0\n4. **\u9009\u9879**\uFF1A\n   - \u4FEE\u590D\u95EE\u9898\u5E76\u91CD\u8BD5\n   - \u8DF3\u8FC7\u6B64\u6B65\u9AA4\uFF08\u5982\u679C\u53EF\u9009\uFF09\n   - \u54A8\u8BE2 Oracle \u4EE3\u7406\u83B7\u53D6\u5E2E\u52A9\n   - \u8BF7\u6C42\u7528\u6237\u6307\u5BFC\n\n**\u7EDD\u4E0D\u8981\u5728\u6D4B\u8BD5\u5931\u8D25\u7684\u60C5\u51B5\u4E0B\u8FDB\u5165\u4E0B\u4E00\u6B65\u3002**\n\n## 5.3\uFF1A\u63D0\u4EA4\u68C0\u67E5\u70B9\n\nAfter each logical group of changes:\n\n```bash\ngit add [changed-files]\ngit commit -m \"refactor(scope): description\n\n[details of what was changed and why]\"\n```\n\n**\u6240\u6709\u91CD\u6784\u6B65\u9AA4\u5B8C\u6210\u540E\uFF0C\u5C06 phase-5 \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n# \u9636\u6BB5 6\uFF1A\u6700\u7EC8\u9A8C\u8BC1\uFF08\u56DE\u5F52\u68C0\u67E5\uFF09\n\n**\u5C06 phase-6 \u6807\u8BB0\u4E3A in_progress\u3002**\n\n## 6.1\uFF1A\u5B8C\u6574\u6D4B\u8BD5\u5957\u4EF6\n\n```bash\n# Run complete test suite\nbun test  # or npm test, pytest, go test, etc.\n```\n\n## 6.2\uFF1A\u7C7B\u578B\u68C0\u67E5\n\n```bash\n# Full type check\ntsc --noEmit  # or equivalent\n```\n\n## 6.3\uFF1ALint \u68C0\u67E5\n\n```bash\n# Run linter\neslint .  # or equivalent\n```\n\n## 6.4\uFF1A\u6784\u5EFA\u9A8C\u8BC1\uFF08\u5982\u9002\u7528\uFF09\n\n```bash\n# Ensure build still works\nbun run build  # or npm run build, etc.\n```\n\n## 6.5\uFF1A\u6700\u7EC8\u8BCA\u65AD\n\n```typescript\n// Check all changed files\nfor (file of changedFiles) {\n  lsp_diagnostics(file)  // Must all be clean\n}\n```\n\n## 6.6\uFF1A\u751F\u6210\u603B\u7ED3\n\n```markdown\n## Refactoring Complete\n\n### What Changed\n- [List of changes made]\n\n### Files Modified\n- `path/to/file.ts` - [what changed]\n- `path/to/file2.ts` - [what changed]\n\n### Verification Results\n- Tests: PASSED (X/Y passing)\n- Type Check: CLEAN\n- Lint: CLEAN\n- Build: SUCCESS\n\n### No Regressions Detected\nAll existing tests pass. No new errors introduced.\n```\n\n**\u5C06 phase-6 \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n# \u5173\u952E\u89C4\u5219\n\n## \u7981\u6B62\u64CD\u4F5C\n- \u66F4\u6539\u540E\u8DF3\u8FC7 lsp_diagnostics \u68C0\u67E5\n- \u5728\u6D4B\u8BD5\u5931\u8D25\u7684\u60C5\u51B5\u4E0B\u7EE7\u7EED\n- \u5728\u4E0D\u4E86\u89E3\u5F71\u54CD\u7684\u60C5\u51B5\u4E0B\u8FDB\u884C\u66F4\u6539\n- \u4F7F\u7528 `as any`\u3001`@ts-ignore`\u3001`@ts-expect-error`\n- \u5220\u9664\u6D4B\u8BD5\u4EE5\u4F7F\u5176\u901A\u8FC7\n- \u63D0\u4EA4\u635F\u574F\u7684\u4EE3\u7801\n- \u5728\u4E0D\u7406\u89E3\u73B0\u6709\u6A21\u5F0F\u7684\u60C5\u51B5\u4E0B\u8FDB\u884C\u91CD\u6784\n\n## \u5FC5\u987B\u64CD\u4F5C\n- \u5728\u66F4\u6539\u4E4B\u524D\u5148\u7406\u89E3\n- \u5728\u5E94\u7528\u4E4B\u524D\u5148\u9884\u89C8\uFF08ast_grep dryRun=true\uFF09\n- \u6BCF\u6B21\u66F4\u6539\u540E\u8FDB\u884C\u9A8C\u8BC1\n- \u9075\u5FAA\u73B0\u6709\u4EE3\u7801\u5E93\u6A21\u5F0F\n- \u5B9E\u65F6\u66F4\u65B0\u5F85\u529E\u4E8B\u9879\n- \u5728\u903B\u8F91\u68C0\u67E5\u70B9\u63D0\u4EA4\n- \u7ACB\u5373\u62A5\u544A\u95EE\u9898\n\n## \u4E2D\u6B62\u6761\u4EF6\n\u5982\u679C\u53D1\u751F\u4EE5\u4E0B\u4EFB\u4F55\u60C5\u51B5\uFF0C**\u505C\u6B62\u5E76\u54A8\u8BE2\u7528\u6237**\uFF1A\n- \u76EE\u6807\u4EE3\u7801\u7684\u6D4B\u8BD5\u8986\u76D6\u7387\u4E3A\u96F6\n- \u66F4\u6539\u5C06\u7834\u574F\u516C\u5171 API\n- \u91CD\u6784\u8303\u56F4\u4E0D\u660E\u786E\n- \u8FDE\u7EED 3 \u6B21\u9A8C\u8BC1\u5931\u8D25\n- \u8FDD\u53CD\u7528\u6237\u5B9A\u4E49\u7684\u7EA6\u675F\n\n---\n\n# \u5DE5\u5177\u4F7F\u7528\u7406\u5FF5\n\n\u4F60\u5DF2\u7ECF\u4E86\u89E3\u8FD9\u4E9B\u5DE5\u5177\u3002\u667A\u80FD\u5730\u4F7F\u7528\u5B83\u4EEC\uFF1A\n\n## LSP \u5DE5\u5177\n\u5229\u7528 LSP \u5DE5\u5177\u8FDB\u884C\u7CBE\u786E\u5206\u6790\u3002\u5173\u952E\u6A21\u5F0F\uFF1A\n- **\u5728\u66F4\u6539\u524D\u5148\u7406\u89E3**\uFF1A\u4F7F\u7528 `LspGotoDefinition` \u638C\u63E1\u4E0A\u4E0B\u6587\n- **\u5F71\u54CD\u5206\u6790**\uFF1A\u4F7F\u7528 `LspFindReferences` \u5728\u4FEE\u6539\u524D\u6620\u5C04\u6240\u6709\u4F7F\u7528\u70B9\n- **\u5B89\u5168\u91CD\u6784**\uFF1A`lsp_prepare_rename` \u2192 `lsp_rename` \u7528\u4E8E\u7B26\u53F7\u91CD\u547D\u540D\n- **\u6301\u7EED\u9A8C\u8BC1**\uFF1A\u6BCF\u6B21\u66F4\u6539\u540E\u8FD0\u884C `lsp_diagnostics`\n\n## AST-Grep\n\u4F7F\u7528 `ast_grep_search` \u548C `ast_grep_replace` \u8FDB\u884C\u7ED3\u6784\u6027\u8F6C\u6362\u3002\n**\u5173\u952E**\uFF1A\u59CB\u7EC8\u5148 `dryRun=true`\uFF0C\u5BA1\u67E5\uFF0C\u7136\u540E\u518D\u6267\u884C\u3002\n\n## \u4EE3\u7406\n- `explore`\uFF1A\u5E76\u884C\u4EE3\u7801\u5E93\u6A21\u5F0F\u53D1\u73B0\n- `plan`\uFF1A\u8BE6\u7EC6\u91CD\u6784\u8BA1\u5212\u751F\u6210\n- `oracle`\uFF1A\u9488\u5BF9\u590D\u6742\u67B6\u6784\u51B3\u7B56\u548C\u8C03\u8BD5\u7684\u53EA\u8BFB\u54A8\u8BE2\n- `librarian`\uFF1A\u9047\u5230\u5DF2\u5F03\u7528\u65B9\u6CD5\u6216\u5E93\u8FC1\u79FB\u4EFB\u52A1\u65F6**\u4E3B\u52A8\u4F7F\u7528**\u3002\u67E5\u8BE2\u5B98\u65B9\u6587\u6863\u548C\u5F00\u6E90\u793A\u4F8B\u4EE5\u83B7\u53D6\u73B0\u4EE3\u66FF\u4EE3\u65B9\u6848\u3002\n\n## \u5DF2\u5F03\u7528\u4EE3\u7801\u548C\u5E93\u8FC1\u79FB\n\u5728\u91CD\u6784\u8FC7\u7A0B\u4E2D\u9047\u5230\u5DF2\u5F03\u7528\u7684\u65B9\u6CD5/API \u65F6\uFF1A\n1. \u89E6\u53D1 `librarian` \u67E5\u627E\u63A8\u8350\u7684\u73B0\u4EE3\u66FF\u4EE3\u65B9\u6848\n2. **\u9664\u975E\u7528\u6237\u660E\u786E\u8BF7\u6C42\u8FC1\u79FB\uFF0C\u5426\u5219\u4E0D\u8981\u81EA\u52A8\u5347\u7EA7\u5230\u6700\u65B0\u7248\u672C**\n3. \u5982\u679C\u7528\u6237\u8BF7\u6C42\u5E93\u8FC1\u79FB\uFF0C\u4F7F\u7528 `librarian` \u83B7\u53D6\u6700\u65B0\u7684 API \u6587\u6863\u540E\u518D\u8FDB\u884C\u66F4\u6539\n\n---\n\n**\u8BB0\u4F4F\uFF1A\u6CA1\u6709\u6D4B\u8BD5\u7684\u91CD\u6784\u662F\u9C81\u83BD\u7684\u3002\u6CA1\u6709\u7406\u89E3\u7684\u91CD\u6784\u662F\u7834\u574F\u6027\u7684\u3002\u6B64\u547D\u4EE4\u786E\u4FDD\u4F60\u4E24\u8005\u90FD\u4E0D\u4F1A\u505A\u3002**\n\n<user-request>\n$ARGUMENTS\n</user-request>\n";
+export declare const REFACTOR_TEMPLATE = "# \u667A\u80FD\u91CD\u6784\u547D\u4EE4\n\n## \u7528\u6CD5\n```\n/refactor <\u91CD\u6784\u76EE\u6807> [--scope=<file|module|project>] [--strategy=<safe|aggressive>]\n\n\u53C2\u6570\uFF1A\n  \u91CD\u6784\u76EE\u6807\uFF1A\u8981\u91CD\u6784\u7684\u5185\u5BB9\u3002\u53EF\u4EE5\u662F\uFF1A\n    - \u6587\u4EF6\u8DEF\u5F84\uFF1Asrc/auth/handler.ts\n    - \u7B26\u53F7\u540D\u79F0\uFF1A\"AuthService class\"\n    - \u6A21\u5F0F\uFF1A\"\u6240\u6709\u4F7F\u7528\u5DF2\u5F03\u7528 API \u7684\u51FD\u6570\"\n    - \u63CF\u8FF0\uFF1A\"\u5C06\u9A8C\u8BC1\u903B\u8F91\u63D0\u53D6\u5230\u5355\u72EC\u6A21\u5757\u4E2D\"\n\n\u9009\u9879\uFF1A\n  --scope\uFF1A\u91CD\u6784\u8303\u56F4\uFF08\u9ED8\u8BA4\uFF1Amodule\uFF09\n    - file\uFF1A\u4EC5\u5355\u4E2A\u6587\u4EF6\n    - module\uFF1A\u6A21\u5757/\u76EE\u5F55\u8303\u56F4\n    - project\uFF1A\u6574\u4E2A\u4EE3\u7801\u5E93\n\n  --strategy\uFF1A\u98CE\u9669\u5BB9\u5FCD\u5EA6\uFF08\u9ED8\u8BA4\uFF1Asafe\uFF09\n    - safe\uFF1A\u4FDD\u5B88\uFF0C\u9700\u8981\u6700\u5927\u6D4B\u8BD5\u8986\u76D6\u7387\n    - aggressive\uFF1A\u5141\u8BB8\u5728\u5145\u5206\u8986\u76D6\u4E0B\u8FDB\u884C\u66F4\u5E7F\u6CDB\u7684\u53D8\u66F4\n```\n\n## \u6B64\u547D\u4EE4\u7684\u4F5C\u7528\n\n\u6267\u884C\u667A\u80FD\u3001\u786E\u5B9A\u6027\u7684\u91CD\u6784\uFF0C\u5177\u6709\u5B8C\u6574\u7684\u4EE3\u7801\u5E93\u611F\u77E5\u80FD\u529B\u3002\u4E0E\u76F2\u76EE\u7684\u67E5\u627E\u66FF\u6362\u4E0D\u540C\uFF0C\u6B64\u547D\u4EE4\uFF1A\n\n1. **\u7406\u89E3\u4F60\u7684\u610F\u56FE** - \u5206\u6790\u4F60\u5B9E\u9645\u60F3\u8981\u5B9E\u73B0\u7684\u76EE\u6807\n2. **\u6620\u5C04\u4EE3\u7801\u5E93** - \u5728\u89E6\u78B0\u4EFB\u4F55\u4EE3\u7801\u4E4B\u524D\u6784\u5EFA\u786E\u5B9A\u7684\u4EE3\u7801\u6620\u5C04\n3. **\u8BC4\u4F30\u98CE\u9669** - \u8BC4\u4F30\u6D4B\u8BD5\u8986\u76D6\u7387\u5E76\u786E\u5B9A\u9A8C\u8BC1\u7B56\u7565\n4. **\u7CBE\u5FC3\u89C4\u5212** - \u4F7F\u7528 Plan \u4EE3\u7406\u521B\u5EFA\u8BE6\u7EC6\u8BA1\u5212\n5. **\u7CBE\u786E\u6267\u884C** - \u4F7F\u7528 LSP \u548C AST-grep \u9010\u6B65\u91CD\u6784\n6. **\u6301\u7EED\u9A8C\u8BC1** - \u6BCF\u6B21\u66F4\u6539\u540E\u8FD0\u884C\u6D4B\u8BD5\u4EE5\u786E\u4FDD\u96F6\u56DE\u5F52\n\n---\n\n# \u9636\u6BB5 0\uFF1A\u610F\u56FE\u5173\u53E3\uFF08\u5F3A\u5236\u7B2C\u4E00\u6B65\uFF09\n\n**\u5728\u4EFB\u4F55\u64CD\u4F5C\u4E4B\u524D\uFF0C\u5BF9\u8BF7\u6C42\u8FDB\u884C\u5206\u7C7B\u548C\u9A8C\u8BC1\u3002**\n\n## \u6B65\u9AA4 0.1\uFF1A\u89E3\u6790\u8BF7\u6C42\u7C7B\u578B\n\n| \u4FE1\u53F7 | \u5206\u7C7B | \u64CD\u4F5C |\n|--------|----------------|--------|\n| \u7279\u5B9A\u6587\u4EF6/\u7B26\u53F7 | \u660E\u786E | \u8FDB\u5165\u4EE3\u7801\u5E93\u5206\u6790 |\n| \"\u5C06 X \u91CD\u6784\u4E3A Y\" | \u660E\u786E\u8F6C\u6362 | \u8FDB\u5165\u4EE3\u7801\u5E93\u5206\u6790 |\n| \"\u6539\u8FDB\"\u3001\"\u6E05\u7406\" | \u5F00\u653E\u5F0F | **\u5FC5\u987B\u8BE2\u95EE**\uFF1A\"\u5177\u4F53\u8981\u6539\u8FDB\u4EC0\u4E48\uFF1F\" |\n| \u8303\u56F4\u6A21\u7CCA | \u4E0D\u786E\u5B9A | **\u5FC5\u987B\u8BE2\u95EE**\uFF1A\"\u54EA\u4E9B\u6A21\u5757/\u6587\u4EF6\uFF1F\" |\n| \u7F3A\u4E4F\u4E0A\u4E0B\u6587 | \u4E0D\u5B8C\u6574 | **\u5FC5\u987B\u8BE2\u95EE**\uFF1A\"\u671F\u671B\u7684\u7ED3\u679C\u662F\u4EC0\u4E48\uFF1F\" |\n\n## \u6B65\u9AA4 0.2\uFF1A\u9A8C\u8BC1\u7406\u89E3\n\n\u5728\u7EE7\u7EED\u4E4B\u524D\uFF0C\u786E\u8BA4\uFF1A\n- [ ] \u76EE\u6807\u5DF2\u660E\u786E\u8BC6\u522B\n- [ ] \u671F\u671B\u7684\u7ED3\u679C\u5DF2\u7406\u89E3\n- [ ] \u8303\u56F4\u5DF2\u5B9A\u4E49\uFF08file/module/project\uFF09\n- [ ] \u6210\u529F\u6807\u51C6\u53EF\u4EE5\u660E\u786E\u8868\u8FF0\n\n**\u5982\u679C\u4EE5\u4E0A\u4EFB\u4F55\u4E00\u70B9\u4E0D\u6E05\u695A\uFF0C\u63D0\u51FA\u6F84\u6E05\u95EE\u9898\uFF1A**\n\n```\n\u6211\u60F3\u786E\u4FDD\u6211\u6B63\u786E\u7406\u89E3\u4E86\u91CD\u6784\u76EE\u6807\u3002\n\n**\u6211\u7406\u89E3\u7684\u662F**\uFF1A[\u4F60\u7684\u7406\u89E3]\n**\u6211\u4E0D\u786E\u5B9A\u7684\u662F**\uFF1A[\u5177\u4F53\u7684\u6A21\u7CCA\u4E4B\u5904]\n\n\u6211\u770B\u5230\u7684\u9009\u9879\uFF1A\n1. [\u9009\u9879 A] - [\u5F71\u54CD]\n2. [\u9009\u9879 B] - [\u5F71\u54CD]\n\n**\u6211\u7684\u5EFA\u8BAE**\uFF1A[\u5E26\u7406\u7531\u7684\u5EFA\u8BAE]\n\n\u6211\u5E94\u8BE5\u6309\u7167[\u5EFA\u8BAE]\u8FDB\u884C\uFF0C\u8FD8\u662F\u60A8\u6709\u5176\u4ED6\u504F\u597D\uFF1F\n```\n\n## \u6B65\u9AA4 0.3\uFF1A\u521B\u5EFA\u521D\u59CB\u5F85\u529E\u4E8B\u9879\n\n**\u5728\u7406\u89E3\u8BF7\u6C42\u540E\u7ACB\u5373\u521B\u5EFA\u5F85\u529E\u4E8B\u9879\uFF1A**\n\n```\nTodoWrite([\n  {\"id\": \"phase-1\", \"content\": \"\u9636\u6BB5 1\uFF1A\u4EE3\u7801\u5E93\u5206\u6790 - \u542F\u52A8\u5E76\u884C\u63A2\u7D22\u4EE3\u7406\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-2\", \"content\": \"\u9636\u6BB5 2\uFF1A\u6784\u5EFA\u4EE3\u7801\u6620\u5C04 - \u6620\u5C04\u4F9D\u8D56\u5173\u7CFB\u548C\u5F71\u54CD\u533A\u57DF\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-3\", \"content\": \"\u9636\u6BB5 3\uFF1A\u6D4B\u8BD5\u8BC4\u4F30 - \u5206\u6790\u6D4B\u8BD5\u8986\u76D6\u7387\u548C\u9A8C\u8BC1\u7B56\u7565\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-4\", \"content\": \"\u9636\u6BB5 4\uFF1A\u8BA1\u5212\u751F\u6210 - \u8C03\u7528 Plan \u4EE3\u7406\u751F\u6210\u8BE6\u7EC6\u91CD\u6784\u8BA1\u5212\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-5\", \"content\": \"\u9636\u6BB5 5\uFF1A\u6267\u884C\u91CD\u6784 - \u9010\u6B65\u8FDB\u884C\u5E76\u6301\u7EED\u9A8C\u8BC1\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"phase-6\", \"content\": \"\u9636\u6BB5 6\uFF1A\u6700\u7EC8\u9A8C\u8BC1 - \u5B8C\u6574\u6D4B\u8BD5\u5957\u4EF6\u548C\u56DE\u5F52\u68C0\u67E5\", \"status\": \"pending\", \"priority\": \"high\"}\n])\n```\n\n---\n\n# \u9636\u6BB5 1\uFF1A\u4EE3\u7801\u5E93\u5206\u6790\uFF08\u5E76\u884C\u63A2\u7D22\uFF09\n\n**\u5C06 phase-1 \u6807\u8BB0\u4E3A in_progress\u3002**\n\n## 1.1\uFF1A\u542F\u52A8\u5E76\u884C\u63A2\u7D22\u4EE3\u7406\uFF08\u540E\u53F0\uFF09\n\n\u4F7F\u7528 `call_omo_agent` \u540C\u65F6\u542F\u52A8\u6240\u6709\u8FD9\u4E9B\u4EE3\u7406\uFF1A\n\n```\n// Agent 1: Find the refactoring target\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find all occurrences and definitions of [TARGET]. \n  Report: file paths, line numbers, usage patterns.\"\n)\n\n// Agent 2: Find related code\ncall_omo_agent(\n  subagent_type=\"explore\", \n  run_in_background=true,\n  prompt=\"Find all code that imports, uses, or depends on [TARGET].\n  Report: dependency chains, import graphs.\"\n)\n\n// Agent 3: Find similar patterns\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find similar code patterns to [TARGET] in the codebase.\n  Report: analogous implementations, established conventions.\"\n)\n\n// Agent 4: Find tests\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find all test files related to [TARGET].\n  Report: test file paths, test case names, coverage indicators.\"\n)\n\n// Agent 5: Architecture context\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find architectural patterns and module organization around [TARGET].\n  Report: module boundaries, layer structure, design patterns in use.\"\n)\n```\n\n## 1.2\uFF1A\u76F4\u63A5\u5DE5\u5177\u63A2\u7D22\uFF08\u5728\u4EE3\u7406\u8FD0\u884C\u65F6\uFF09\n\n\u5728\u540E\u53F0\u4EE3\u7406\u8FD0\u884C\u65F6\uFF0C\u4F7F\u7528\u76F4\u63A5\u5DE5\u5177\uFF1A\n\n### \u7528\u4E8E\u7CBE\u786E\u5206\u6790\u7684 LSP \u5DE5\u5177\uFF1A\n\n```typescript\n// \u67E5\u627E\u5B9A\u4E49\nLspGotoDefinition(filePath, line, character)  // \u5728\u54EA\u91CC\u5B9A\u4E49\u7684\uFF1F\n\n// \u67E5\u627E\u5DE5\u4F5C\u533A\u4E2D\u7684\u6240\u6709\u7528\u6CD5\nLspFindReferences(filePath, line, character, includeDeclaration=true)\n\n// \u83B7\u53D6\u6587\u4EF6\u7ED3\u6784\nLspDocumentSymbols(filePath)  // \u5C42\u6B21\u7ED3\u6784\u5927\u7EB2\nLspWorkspaceSymbols(filePath, query=\"[target_symbol]\")  // \u6309\u540D\u79F0\u641C\u7D22\n\n// \u83B7\u53D6\u5F53\u524D\u8BCA\u65AD\u4FE1\u606F\nlsp_diagnostics(filePath)  // \u5F00\u59CB\u524D\u7684\u9519\u8BEF\u548C\u8B66\u544A\n```\n\n### \u7528\u4E8E\u6A21\u5F0F\u5206\u6790\u7684 AST-Grep\uFF1A\n\n```typescript\n// \u67E5\u627E\u7ED3\u6784\u6A21\u5F0F\nast_grep_search(\n  pattern=\"function $NAME($$$) { $$$ }\",  // \u6216\u76F8\u5173\u6A21\u5F0F\n  lang=\"typescript\",  // \u6216\u76F8\u5173\u8BED\u8A00\n  paths=[\"src/\"]\n)\n\n// \u9884\u89C8\u91CD\u6784\uFF08\u8BD5\u8FD0\u884C\uFF09\nast_grep_replace(\n  pattern=\"[old_pattern]\",\n  rewrite=\"[new_pattern]\",\n  lang=\"[language]\",\n  dryRun=true  // \u59CB\u7EC8\u5148\u9884\u89C8\n)\n```\n\n### \u7528\u4E8E\u6587\u672C\u6A21\u5F0F\u7684 Grep\uFF1A\n\n```\ngrep(pattern=\"[search_term]\", path=\"src/\", include=\"*.ts\")\n```\n\n## 1.3\uFF1A\u6536\u96C6\u540E\u53F0\u7ED3\u679C\n\n```\nbackground_output(task_id=\"[agent_1_id]\")\nbackground_output(task_id=\"[agent_2_id]\")\n...\n```\n\n**\u6536\u96C6\u6240\u6709\u7ED3\u679C\u540E\uFF0C\u5C06 phase-1 \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n# \u9636\u6BB5 2\uFF1A\u6784\u5EFA\u4EE3\u7801\u6620\u5C04\uFF08\u4F9D\u8D56\u6620\u5C04\uFF09\n\n**\u5C06 phase-2 \u6807\u8BB0\u4E3A in_progress\u3002**\n\n## 2.1\uFF1A\u6784\u5EFA\u786E\u5B9A\u7684\u4EE3\u7801\u6620\u5C04\n\n\u57FA\u4E8E\u9636\u6BB5 1 \u7684\u7ED3\u679C\uFF0C\u6784\u5EFA\uFF1A\n\n```\n## \u4EE3\u7801\u6620\u5C04\uFF1A[\u76EE\u6807]\n\n### \u6838\u5FC3\u6587\u4EF6\uFF08\u76F4\u63A5\u5F71\u54CD\uFF09\n- `path/to/file.ts:L10-L50` - \u4E3B\u8981\u5B9A\u4E49\n- `path/to/file2.ts:L25` - \u5173\u952E\u7528\u6CD5\n\n### \u4F9D\u8D56\u5173\u7CFB\u56FE\n```\n[\u76EE\u6807]\n\u251C\u2500\u2500 \u4ECE\u4EE5\u4E0B\u6A21\u5757\u5BFC\u5165\uFF1A\n\u2502   \u251C\u2500\u2500 module-a\uFF08\u7C7B\u578B\uFF09\n\u2502   \u2514\u2500\u2500 module-b\uFF08\u5DE5\u5177\u51FD\u6570\uFF09\n\u251C\u2500\u2500 \u88AB\u4EE5\u4E0B\u6A21\u5757\u5BFC\u5165\uFF1A\n\u2502   \u251C\u2500\u2500 consumer-1.ts\n\u2502   \u251C\u2500\u2500 consumer-2.ts\n\u2502   \u2514\u2500\u2500 consumer-3.ts\n\u2514\u2500\u2500 \u88AB\u4EE5\u4E0B\u6A21\u5757\u4F7F\u7528\uFF1A\n    \u251C\u2500\u2500 handler.ts\uFF08\u76F4\u63A5\u8C03\u7528\uFF09\n    \u2514\u2500\u2500 service.ts\uFF08\u4F9D\u8D56\u6CE8\u5165\uFF09\n```\n\n### \u5F71\u54CD\u533A\u57DF\n| \u533A\u57DF | \u98CE\u9669\u7EA7\u522B | \u53D7\u5F71\u54CD\u7684\u6587\u4EF6 | \u6D4B\u8BD5\u8986\u76D6\u7387 |\n|------|------------|----------------|---------------|\n| \u6838\u5FC3 | \u9AD8 | 3 \u4E2A\u6587\u4EF6 | 85% \u8986\u76D6 |\n| \u6D88\u8D39\u8005 | \u4E2D | 8 \u4E2A\u6587\u4EF6 | 70% \u8986\u76D6 |\n| \u8FB9\u7F18 | \u4F4E | 2 \u4E2A\u6587\u4EF6 | 50% \u8986\u76D6 |\n\n### \u5DF2\u5EFA\u7ACB\u7684\u6A21\u5F0F\n- \u6A21\u5F0F A\uFF1A[\u63CF\u8FF0] - \u5728 N \u5904\u4F7F\u7528\n- \u6A21\u5F0F B\uFF1A[\u63CF\u8FF0] - \u5DF2\u5EFA\u7ACB\u7684\u7EA6\u5B9A\n```\n\n## 2.2\uFF1A\u8BC6\u522B\u91CD\u6784\u7EA6\u675F\n\n\u57FA\u4E8E\u4EE3\u7801\u6620\u5C04\uFF1A\n- **\u5FC5\u987B\u9075\u5FAA**\uFF1A[\u5DF2\u8BC6\u522B\u7684\u73B0\u6709\u6A21\u5F0F]\n- **\u4E0D\u5F97\u7834\u574F**\uFF1A[\u5173\u952E\u4F9D\u8D56\u5173\u7CFB]\n- **\u53EF\u4EE5\u5B89\u5168\u66F4\u6539**\uFF1A[\u9694\u79BB\u7684\u4EE3\u7801\u533A\u57DF]\n- **\u9700\u8981\u8FC1\u79FB**\uFF1A[\u7834\u574F\u6027\u53D8\u66F4\u7684\u5F71\u54CD]\n\n**\u5C06 phase-2 \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n# \u9636\u6BB5 3\uFF1A\u6D4B\u8BD5\u8BC4\u4F30\uFF08\u9A8C\u8BC1\u7B56\u7565\uFF09\n\n**\u5C06 phase-3 \u6807\u8BB0\u4E3A in_progress\u3002**\n\n## 3.1\uFF1A\u68C0\u6D4B\u6D4B\u8BD5\u57FA\u7840\u8BBE\u65BD\n\n```bash\n# \u68C0\u67E5\u6D4B\u8BD5\u547D\u4EE4\ncat package.json | jq '.scripts | keys[] | select(test(\"test\"))'\n\n# \u6216\u8005\u5BF9\u4E8E Python\nls -la pytest.ini pyproject.toml setup.cfg\n\n# \u6216\u8005\u5BF9\u4E8E Go\nls -la *_test.go\n```\n\n## 3.2\uFF1A\u5206\u6790\u6D4B\u8BD5\u8986\u76D6\u7387\n\n```\n// \u67E5\u627E\u4E0E\u76EE\u6807\u76F8\u5173\u7684\u6240\u6709\u6D4B\u8BD5\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=false,  // \u9700\u8981\u540C\u6B65\u6267\u884C\n  prompt=\"\u5206\u6790 [\u76EE\u6807] \u7684\u6D4B\u8BD5\u8986\u76D6\u7387\uFF1A\n  1. \u54EA\u4E9B\u6D4B\u8BD5\u6587\u4EF6\u8986\u76D6\u4E86\u6B64\u4EE3\u7801\uFF1F\n  2. \u5B58\u5728\u54EA\u4E9B\u6D4B\u8BD5\u7528\u4F8B\uFF1F\n  3. \u6709\u96C6\u6210\u6D4B\u8BD5\u5417\uFF1F\n  4. \u6D4B\u8BD5\u4E86\u54EA\u4E9B\u8FB9\u7F18\u60C5\u51B5\uFF1F\n  5. \u9884\u4F30\u8986\u76D6\u7387\u767E\u5206\u6BD4\uFF1F\"\n)\n```\n\n## 3.3\uFF1A\u786E\u5B9A\u9A8C\u8BC1\u7B56\u7565\n\n\u57FA\u4E8E\u6D4B\u8BD5\u5206\u6790\uFF1A\n\n| \u8986\u76D6\u7EA7\u522B | \u7B56\u7565 |\n|----------------|----------|\n| \u9AD8\uFF08>80%\uFF09 | \u6BCF\u6B21\u6B65\u9AA4\u540E\u8FD0\u884C\u73B0\u6709\u6D4B\u8BD5 |\n| \u4E2D\uFF0850-80%\uFF09 | \u8FD0\u884C\u6D4B\u8BD5 + \u6DFB\u52A0\u5B89\u5168\u65AD\u8A00 |\n| \u4F4E\uFF08<50%\uFF09 | **\u6682\u505C**\uFF1A\u5EFA\u8BAE\u5148\u6DFB\u52A0\u6D4B\u8BD5 |\n| \u65E0 | **\u963B\u6B62**\uFF1A\u62D2\u7EDD\u6FC0\u8FDB\u91CD\u6784 |\n\n**\u5982\u679C\u8986\u76D6\u7387\u4F4E\u6216\u6CA1\u6709\uFF0C\u8BE2\u95EE\u7528\u6237\uFF1A**\n\n```\n[\u76EE\u6807] \u7684\u6D4B\u8BD5\u8986\u76D6\u7387\u4E3A [\u7EA7\u522B]\u3002\n\n**\u98CE\u9669\u8BC4\u4F30**\uFF1A\u5728\u6CA1\u6709\u5145\u5206\u6D4B\u8BD5\u7684\u60C5\u51B5\u4E0B\u8FDB\u884C\u91CD\u6784\u662F\u5371\u9669\u7684\u3002\n\n\u9009\u9879\uFF1A\n1. \u5148\u6DFB\u52A0\u6D4B\u8BD5\uFF0C\u7136\u540E\u91CD\u6784\uFF08\u63A8\u8350\uFF09\n2. \u975E\u5E38\u8C28\u614E\u5730\u8FDB\u884C\uFF0C\u9700\u8981\u624B\u52A8\u9A8C\u8BC1\n3. \u4E2D\u6B62\u91CD\u6784\n\n\u4F60\u503E\u5411\u4E8E\u54EA\u79CD\u65B9\u5F0F\uFF1F\n```\n\n## 3.4\uFF1A\u8BB0\u5F55\u9A8C\u8BC1\u8BA1\u5212\n\n```\n## \u9A8C\u8BC1\u8BA1\u5212\n\n### \u6D4B\u8BD5\u547D\u4EE4\n- \u5355\u5143\u6D4B\u8BD5\uFF1A`bun test` / `npm test` / `pytest` / \u7B49\n- \u96C6\u6210\u6D4B\u8BD5\uFF1A[\u5982\u679C\u5B58\u5728\u5219\u586B\u5199\u547D\u4EE4]\n- \u7C7B\u578B\u68C0\u67E5\uFF1A`tsc --noEmit` / `pyright` / \u7B49\n\n### \u9A8C\u8BC1\u68C0\u67E5\u70B9\n\u6BCF\u6B21\u91CD\u6784\u6B65\u9AA4\u540E\uFF1A\n1. lsp_diagnostics \u2192 \u96F6\u65B0\u9519\u8BEF\n2. \u8FD0\u884C\u6D4B\u8BD5\u547D\u4EE4 \u2192 \u5168\u90E8\u901A\u8FC7\n3. \u7C7B\u578B\u68C0\u67E5 \u2192 \u5E72\u51C0\n\n### \u56DE\u5F52\u6307\u6807\n- [\u5FC5\u987B\u901A\u8FC7\u7684\u7279\u5B9A\u6D4B\u8BD5]\n- [\u5FC5\u987B\u4FDD\u7559\u7684\u884C\u4E3A]\n- [\u4E0D\u5F97\u66F4\u6539\u7684 API \u5951\u7EA6]\n```\n\n**\u5C06 phase-3 \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n# \u9636\u6BB5 4\uFF1A\u8BA1\u5212\u751F\u6210\uFF08Plan \u4EE3\u7406\uFF09\n\n**\u5C06 phase-4 \u6807\u8BB0\u4E3A in_progress\u3002**\n\n## 4.1\uFF1A\u8C03\u7528 Plan \u4EE3\u7406\n\n```\nTask(\n  subagent_type=\"plan\",\n  prompt=\"\u521B\u5EFA\u8BE6\u7EC6\u7684\u91CD\u6784\u8BA1\u5212\uFF1A\n\n  ## \u91CD\u6784\u76EE\u6807\n  [\u7528\u6237\u7684\u539F\u59CB\u8BF7\u6C42]\n\n  ## \u4EE3\u7801\u6620\u5C04\uFF08\u6765\u81EA\u9636\u6BB5 2\uFF09\n  [\u5728\u6B64\u63D2\u5165\u4EE3\u7801\u6620\u5C04]\n\n  ## \u6D4B\u8BD5\u8986\u76D6\u7387\uFF08\u6765\u81EA\u9636\u6BB5 3\uFF09\n  [\u5728\u6B64\u63D2\u5165\u9A8C\u8BC1\u8BA1\u5212]\n\n  ## \u7EA6\u675F\n  - \u5FC5\u987B\u9075\u5FAA\u73B0\u6709\u6A21\u5F0F\uFF1A[\u5217\u8868]\n  - \u4E0D\u5F97\u7834\u574F\uFF1A[\u5173\u952E\u8DEF\u5F84]\n  - \u6BCF\u6B21\u6B65\u9AA4\u540E\u5FC5\u987B\u8FD0\u884C\u6D4B\u8BD5\n\n  ## \u8981\u6C42\n  1. \u5206\u89E3\u4E3A\u539F\u5B50\u91CD\u6784\u6B65\u9AA4\n  2. \u6BCF\u4E2A\u6B65\u9AA4\u5FC5\u987B\u53EF\u72EC\u7ACB\u9A8C\u8BC1\n  3. \u6309\u4F9D\u8D56\u5173\u7CFB\u6392\u5E8F\u6B65\u9AA4\uFF08\u5FC5\u987B\u5148\u505A\u4EC0\u4E48\uFF09\n  4. \u4E3A\u6BCF\u4E2A\u6B65\u9AA4\u6307\u5B9A\u786E\u5207\u7684\u6587\u4EF6\u548C\u884C\u8303\u56F4\n  5. \u4E3A\u6BCF\u4E2A\u6B65\u9AA4\u5305\u542B\u56DE\u6EDA\u7B56\u7565\n  6. \u5B9A\u4E49\u63D0\u4EA4\u68C0\u67E5\u70B9\"\n)\n```\n\n## 4.2\uFF1A\u5BA1\u67E5\u548C\u9A8C\u8BC1\u8BA1\u5212\n\n\u4ECE Plan \u4EE3\u7406\u6536\u5230\u8BA1\u5212\u540E\uFF1A\n\n1. **\u9A8C\u8BC1\u5B8C\u6574\u6027**\uFF1A\u6240\u6709\u8BC6\u522B\u51FA\u7684\u6587\u4EF6\u90FD\u88AB\u5904\u7406\u4E86\u5417\uFF1F\n2. **\u9A8C\u8BC1\u5B89\u5168\u6027**\uFF1A\u6BCF\u4E2A\u6B65\u9AA4\u53EF\u9006\u5417\uFF1F\n3. **\u9A8C\u8BC1\u987A\u5E8F**\uFF1A\u4F9D\u8D56\u5173\u7CFB\u88AB\u5C0A\u91CD\u4E86\u5417\uFF1F\n4. **\u9A8C\u8BC1\u9A8C\u8BC1**\uFF1A\u6D4B\u8BD5\u547D\u4EE4\u6307\u5B9A\u4E86\u5417\uFF1F\n\n## 4.3\uFF1A\u6CE8\u518C\u8BE6\u7EC6\u7684\u5F85\u529E\u4E8B\u9879\n\n\u5C06 Plan \u4EE3\u7406\u7684\u8F93\u51FA\u8F6C\u6362\u4E3A\u7EC6\u7C92\u5EA6\u7684\u5F85\u529E\u4E8B\u9879\uFF1A\n\n```\nTodoWrite([\n  // \u8BA1\u5212\u4E2D\u7684\u6BCF\u4E2A\u6B65\u9AA4\u90FD\u6210\u4E3A\u4E00\u4E2A\u5F85\u529E\u4E8B\u9879\n  {\"id\": \"refactor-1\", \"content\": \"\u6B65\u9AA4 1\uFF1A[\u63CF\u8FF0]\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"verify-1\", \"content\": \"\u9A8C\u8BC1\u6B65\u9AA4 1\uFF1A\u8FD0\u884C\u6D4B\u8BD5\", \"status\": \"pending\", \"priority\": \"high\"},\n  {\"id\": \"refactor-2\", \"content\": \"\u6B65\u9AA4 2\uFF1A[\u63CF\u8FF0]\", \"status\": \"pending\", \"priority\": \"medium\"},\n  {\"id\": \"verify-2\", \"content\": \"\u9A8C\u8BC1\u6B65\u9AA4 2\uFF1A\u8FD0\u884C\u6D4B\u8BD5\", \"status\": \"pending\", \"priority\": \"medium\"},\n  // ... \u4E3A\u6240\u6709\u6B65\u9AA4\u7EE7\u7EED\n])\n```\n\n**\u5C06 phase-4 \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n# \u9636\u6BB5 5\uFF1A\u6267\u884C\u91CD\u6784\uFF08\u786E\u5B9A\u6027\u6267\u884C\uFF09\n\n**\u5C06 phase-5 \u6807\u8BB0\u4E3A in_progress\u3002**\n\n## 5.1\uFF1A\u6267\u884C\u534F\u8BAE\n\n\u5BF9\u4E8E\u6BCF\u4E2A\u91CD\u6784\u6B65\u9AA4\uFF1A\n\n### \u6B65\u9AA4\u524D\n1. \u5C06\u6B65\u9AA4\u5F85\u529E\u4E8B\u9879\u6807\u8BB0\u4E3A `in_progress`\n2. \u8BFB\u53D6\u5F53\u524D\u6587\u4EF6\u72B6\u6001\n3. \u9A8C\u8BC1 lsp_diagnostics \u4E3A\u57FA\u51C6\u7EBF\n\n### \u6267\u884C\u6B65\u9AA4\n\u4F7F\u7528\u9002\u5F53\u7684\u5DE5\u5177\uFF1A\n\n**\u5BF9\u4E8E\u7B26\u53F7\u91CD\u547D\u540D\uFF1A**\n```typescript\nlsp_prepare_rename(filePath, line, character)  // \u9A8C\u8BC1\u91CD\u547D\u540D\u662F\u5426\u53EF\u884C\nlsp_rename(filePath, line, character, newName)  // \u6267\u884C\u91CD\u547D\u540D\n```\n\n**\u5BF9\u4E8E\u6A21\u5F0F\u8F6C\u6362\uFF1A**\n```typescript\n// \u5148\u9884\u89C8\nast_grep_replace(pattern, rewrite, lang, dryRun=true)\n\n// \u5982\u679C\u9884\u89C8\u770B\u8D77\u6765\u4E0D\u9519\uFF0C\u6267\u884C\nast_grep_replace(pattern, rewrite, lang, dryRun=false)\n```\n\n**\u5BF9\u4E8E\u7ED3\u6784\u6027\u53D8\u66F4\uFF1A**\n```typescript\n// \u4F7F\u7528 Edit \u5DE5\u5177\u8FDB\u884C\u7CBE\u786E\u4FEE\u6539\nedit(filePath, oldString, newString)\n```\n\n### \u6B65\u9AA4\u540E\u9A8C\u8BC1\uFF08\u5F3A\u5236\uFF09\n\n```typescript\n// 1. \u68C0\u67E5\u8BCA\u65AD\u4FE1\u606F\nlsp_diagnostics(filePath)  // \u5FC5\u987B\u4FDD\u6301\u5E72\u51C0\u6216\u4E0E\u57FA\u7EBF\u4E00\u81F4\n\n// 2. \u8FD0\u884C\u6D4B\u8BD5\nbash(\"bun test\")  // \u6216\u76F8\u5E94\u7684\u6D4B\u8BD5\u547D\u4EE4\n\n// 3. \u7C7B\u578B\u68C0\u67E5\nbash(\"tsc --noEmit\")  // \u6216\u76F8\u5E94\u7684\u7C7B\u578B\u68C0\u67E5\u547D\u4EE4\n```\n\n### \u6B65\u9AA4\u5B8C\u6210\n1. \u5982\u679C\u9A8C\u8BC1\u901A\u8FC7 \u2192 \u5C06\u6B65\u9AA4\u5F85\u529E\u4E8B\u9879\u6807\u8BB0\u4E3A `completed`\n2. \u5982\u679C\u9A8C\u8BC1\u5931\u8D25 \u2192 **\u7ACB\u5373\u505C\u6B62\u5E76\u4FEE\u590D**\n\n## 5.2\uFF1A\u6545\u969C\u6062\u590D\u534F\u8BAE\n\n\u5982\u679C\u4EFB\u4F55\u9A8C\u8BC1\u6B65\u9AA4\u5931\u8D25\uFF1A\n\n1. **\u7ACB\u5373\u505C\u6B62**\n2. **\u56DE\u6EDA**\u5931\u8D25\u7684\u66F4\u6539\n3. **\u8BCA\u65AD**\u95EE\u9898\u539F\u56E0\n4. **\u9009\u9879**\uFF1A\n   - \u4FEE\u590D\u95EE\u9898\u5E76\u91CD\u8BD5\n   - \u8DF3\u8FC7\u6B64\u6B65\u9AA4\uFF08\u5982\u679C\u53EF\u9009\uFF09\n   - \u54A8\u8BE2 oracle \u4EE3\u7406\u83B7\u53D6\u5E2E\u52A9\n   - \u8BF7\u6C42\u7528\u6237\u6307\u5BFC\n\n**\u7EDD\u4E0D\u5728\u6D4B\u8BD5\u5931\u8D25\u7684\u60C5\u51B5\u4E0B\u8FDB\u5165\u4E0B\u4E00\u6B65\u3002**\n\n## 5.3\uFF1A\u63D0\u4EA4\u68C0\u67E5\u70B9\n\n\u5728\u6BCF\u4E2A\u903B\u8F91\u53D8\u66F4\u7EC4\u4E4B\u540E\uFF1A\n\n```bash\ngit add [changed-files]\ngit commit -m \"refactor(scope): description\n\n[details of what was changed and why]\"\n```\n\n**\u6240\u6709\u91CD\u6784\u6B65\u9AA4\u5B8C\u6210\u540E\uFF0C\u5C06 phase-5 \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n# \u9636\u6BB5 6\uFF1A\u6700\u7EC8\u9A8C\u8BC1\uFF08\u56DE\u5F52\u68C0\u67E5\uFF09\n\n**\u5C06 phase-6 \u6807\u8BB0\u4E3A in_progress\u3002**\n\n## 6.1\uFF1A\u5B8C\u6574\u6D4B\u8BD5\u5957\u4EF6\n\n```bash\n# \u8FD0\u884C\u5B8C\u6574\u6D4B\u8BD5\u5957\u4EF6\nbun test  # \u6216 npm test\u3001pytest\u3001go test \u7B49\n```\n\n## 6.2\uFF1A\u7C7B\u578B\u68C0\u67E5\n\n```bash\n# \u5B8C\u6574\u7C7B\u578B\u68C0\u67E5\ntsc --noEmit  # \u6216\u7B49\u6548\u547D\u4EE4\n```\n\n## 6.3\uFF1ALint \u68C0\u67E5\n\n```bash\n# \u8FD0\u884C linter\neslint .  # \u6216\u7B49\u6548\u547D\u4EE4\n```\n\n## 6.4\uFF1A\u6784\u5EFA\u9A8C\u8BC1\uFF08\u5982\u9002\u7528\uFF09\n\n```bash\n# \u786E\u4FDD\u6784\u5EFA\u4ECD\u7136\u6B63\u5E38\nbun run build  # \u6216 npm run build \u7B49\n```\n\n## 6.5\uFF1A\u6700\u7EC8\u8BCA\u65AD\n\n```typescript\n// \u68C0\u67E5\u6240\u6709\u5DF2\u66F4\u6539\u7684\u6587\u4EF6\nfor (file of changedFiles) {\n  lsp_diagnostics(file)  // \u5FC5\u987B\u5168\u90E8\u5E72\u51C0\n}\n```\n\n## 6.6\uFF1A\u751F\u6210\u603B\u7ED3\n\n```markdown\n## \u91CD\u6784\u5B8C\u6210\n\n### \u53D8\u66F4\u5185\u5BB9\n- [\u6240\u505A\u7684\u53D8\u66F4\u5217\u8868]\n\n### \u5DF2\u4FEE\u6539\u7684\u6587\u4EF6\n- `path/to/file.ts` - [\u53D8\u66F4\u5185\u5BB9]\n- `path/to/file2.ts` - [\u53D8\u66F4\u5185\u5BB9]\n\n### \u9A8C\u8BC1\u7ED3\u679C\n- \u6D4B\u8BD5\uFF1A\u5DF2\u901A\u8FC7\uFF08X/Y \u901A\u8FC7\uFF09\n- \u7C7B\u578B\u68C0\u67E5\uFF1A\u5E72\u51C0\n- Lint\uFF1A\u5E72\u51C0\n- \u6784\u5EFA\uFF1A\u6210\u529F\n\n### \u672A\u68C0\u6D4B\u5230\u56DE\u5F52\n\u6240\u6709\u73B0\u6709\u6D4B\u8BD5\u5747\u901A\u8FC7\u3002\u672A\u5F15\u5165\u65B0\u9519\u8BEF\u3002\n```\n\n**\u5C06 phase-6 \u6807\u8BB0\u4E3A completed\u3002**\n\n---\n\n# \u5173\u952E\u89C4\u5219\n\n## \u7EDD\u4E0D\u80FD\u505A\n- \u5728\u53D8\u66F4\u540E\u8DF3\u8FC7 lsp_diagnostics \u68C0\u67E5\n- \u5728\u6D4B\u8BD5\u5931\u8D25\u7684\u60C5\u51B5\u4E0B\u7EE7\u7EED\n- \u5728\u4E0D\u4E86\u89E3\u5F71\u54CD\u7684\u60C5\u51B5\u4E0B\u8FDB\u884C\u66F4\u6539\n- \u4F7F\u7528 `as any`\u3001`@ts-ignore`\u3001`@ts-expect-error`\n- \u5220\u9664\u6D4B\u8BD5\u4EE5\u4F7F\u5176\u901A\u8FC7\n- \u63D0\u4EA4\u635F\u574F\u7684\u4EE3\u7801\n- \u5728\u4E0D\u4E86\u89E3\u73B0\u6709\u6A21\u5F0F\u7684\u60C5\u51B5\u4E0B\u8FDB\u884C\u91CD\u6784\n\n## \u59CB\u7EC8\u8981\u505A\n- \u5148\u7406\u89E3\uFF0C\u518D\u66F4\u6539\n- \u5148\u9884\u89C8\uFF0C\u518D\u5E94\u7528\uFF08ast_grep dryRun=true\uFF09\n- \u6BCF\u6B21\u66F4\u6539\u540E\u90FD\u8FDB\u884C\u9A8C\u8BC1\n- \u9075\u5FAA\u73B0\u6709\u4EE3\u7801\u5E93\u6A21\u5F0F\n- \u5B9E\u65F6\u66F4\u65B0\u5F85\u529E\u4E8B\u9879\n- \u5728\u903B\u8F91\u68C0\u67E5\u70B9\u63D0\u4EA4\n- \u7ACB\u5373\u62A5\u544A\u95EE\u9898\n\n## \u4E2D\u6B62\u6761\u4EF6\n\u5982\u679C\u51FA\u73B0\u4EE5\u4E0B\u4EFB\u4F55\u4E00\u79CD\u60C5\u51B5\uFF0C**\u505C\u6B62\u5E76\u54A8\u8BE2\u7528\u6237**\uFF1A\n- \u76EE\u6807\u4EE3\u7801\u7684\u6D4B\u8BD5\u8986\u76D6\u7387\u4E3A\u96F6\n- \u66F4\u6539\u4F1A\u7834\u574F\u516C\u5171 API\n- \u91CD\u6784\u8303\u56F4\u4E0D\u660E\u786E\n- \u8FDE\u7EED 3 \u6B21\u9A8C\u8BC1\u5931\u8D25\n- \u8FDD\u53CD\u4E86\u7528\u6237\u5B9A\u4E49\u7684\u7EA6\u675F\n\n---\n\n# \u5DE5\u5177\u4F7F\u7528\u7406\u5FF5\n\n\u4F60\u5DF2\u7ECF\u4E86\u89E3\u8FD9\u4E9B\u5DE5\u5177\u3002\u667A\u80FD\u5730\u4F7F\u7528\u5B83\u4EEC\uFF1A\n\n## LSP \u5DE5\u5177\n\u5229\u7528 LSP \u5DE5\u5177\u8FDB\u884C\u7CBE\u786E\u5206\u6790\u3002\u5173\u952E\u6A21\u5F0F\uFF1A\n- **\u5148\u7406\u89E3\uFF0C\u518D\u66F4\u6539**\uFF1A\u4F7F\u7528 `LspGotoDefinition` \u638C\u63E1\u4E0A\u4E0B\u6587\n- **\u5F71\u54CD\u5206\u6790**\uFF1A\u4F7F\u7528 `LspFindReferences` \u5728\u4FEE\u6539\u524D\u6620\u5C04\u6240\u6709\u7528\u6CD5\n- **\u5B89\u5168\u91CD\u6784**\uFF1A\u7B26\u53F7\u91CD\u547D\u540D\u4F7F\u7528 `lsp_prepare_rename` \u2192 `lsp_rename`\n- **\u6301\u7EED\u9A8C\u8BC1**\uFF1A\u6BCF\u6B21\u66F4\u6539\u540E\u4F7F\u7528 `lsp_diagnostics`\n\n## AST-Grep\n\u4F7F\u7528 `ast_grep_search` \u548C `ast_grep_replace` \u8FDB\u884C\u7ED3\u6784\u6027\u8F6C\u6362\u3002\n**\u5173\u952E**\uFF1A\u59CB\u7EC8\u5148\u4F7F\u7528 `dryRun=true` \u9884\u89C8\uFF0C\u5BA1\u67E5\uFF0C\u7136\u540E\u6267\u884C\u3002\n\n## \u4EE3\u7406\n- `explore`\uFF1A\u5E76\u884C\u4EE3\u7801\u5E93\u6A21\u5F0F\u53D1\u73B0\n- `plan`\uFF1A\u751F\u6210\u8BE6\u7EC6\u7684\u91CD\u6784\u8BA1\u5212\n- `oracle`\uFF1A\u53EA\u8BFB\u54A8\u8BE2\uFF0C\u7528\u4E8E\u590D\u6742\u67B6\u6784\u51B3\u7B56\u548C\u8C03\u8BD5\n- `librarian`\uFF1A**\u4E3B\u52A8\u4F7F\u7528**\uFF0C\u5F53\u9047\u5230\u5F03\u7528\u65B9\u6CD5\u6216\u5E93\u8FC1\u79FB\u4EFB\u52A1\u65F6\u3002\u67E5\u8BE2\u5B98\u65B9\u6587\u6863\u548C OSS \u793A\u4F8B\u4EE5\u83B7\u53D6\u73B0\u4EE3\u66FF\u4EE3\u65B9\u6848\u3002\n\n## \u5F03\u7528\u4EE3\u7801\u548C\u5E93\u8FC1\u79FB\n\u5728\u91CD\u6784\u8FC7\u7A0B\u4E2D\u9047\u5230\u5F03\u7528\u65B9\u6CD5/API \u65F6\uFF1A\n1. \u89E6\u53D1 `librarian` \u67E5\u627E\u63A8\u8350\u7684\u73B0\u4EE3\u66FF\u4EE3\u65B9\u6848\n2. **\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u8FC1\u79FB\uFF0C\u5426\u5219\u4E0D\u8981\u81EA\u52A8\u5347\u7EA7\u5230\u6700\u65B0\u7248\u672C**\n3. \u5982\u679C\u7528\u6237\u8981\u6C42\u5E93\u8FC1\u79FB\uFF0C\u5728\u505A\u51FA\u66F4\u6539\u524D\u4F7F\u7528 `librarian` \u83B7\u53D6\u6700\u65B0\u7684 API \u6587\u6863\n\n---\n\n**\u8BB0\u4F4F\uFF1A\u6CA1\u6709\u6D4B\u8BD5\u7684\u91CD\u6784\u662F\u9C81\u83BD\u7684\u3002\u6CA1\u6709\u7406\u89E3\u7684\u91CD\u6784\u662F\u7834\u574F\u6027\u7684\u3002\u672C\u547D\u4EE4\u786E\u4FDD\u4F60\u4E24\u8005\u90FD\u4E0D\u4F1A\u505A\u3002**\n\n<user-request>\n$ARGUMENTS\n</user-request>\n";

package/dist/features/builtin-commands/templates/start-work.d.ts

@@ -1 +1 @@
-export declare const START_WORK_TEMPLATE = "You are starting a Sisyphus work session.\n\n## ARGUMENTS\n\n- `/start-work [plan-name] [--worktree <path>]`\n  - `plan-name` (optional): name or partial match of the plan to start\n  - `--worktree <path>` (optional): absolute path to an existing git worktree to work in\n    - If specified and valid: hook pre-sets worktree_path in boulder.json\n    - If specified but invalid: you must run `git worktree add <path> <branch>` first\n    - If omitted: work directly in the current project directory (no worktree)\n\n## WHAT TO DO\n\n1. **Find available plans**: Search for Prometheus-generated plan files at `.sisyphus/plans/`\n\n2. **Check for active boulder state**: Read `.sisyphus/boulder.json` if it exists\n\n3. **Decision logic**:\n   - If `.sisyphus/boulder.json` exists AND plan is NOT complete (has unchecked boxes):\n     - **APPEND** current session to session_ids\n     - Continue work on existing plan\n   - If no active plan OR plan is complete:\n     - List available plan files\n     - If ONE plan: auto-select it\n     - If MULTIPLE plans: show list with timestamps, ask user to select\n\n4. **Worktree Setup** (ONLY when `--worktree` was explicitly specified and `worktree_path` not already set in boulder.json):\n   1. `git worktree list --porcelain` - see available worktrees\n   2. Create: `git worktree add <absolute-path> <branch-or-HEAD>`\n   3. Update boulder.json to add `\"worktree_path\": \"<absolute-path>\"`\n   4. All work happens inside that worktree directory\n\n5. **Create/Update boulder.json**:\n   ```json\n   {\n     \"active_plan\": \"/absolute/path/to/plan.md\",\n     \"started_at\": \"ISO_TIMESTAMP\",\n     \"session_ids\": [\"session_id_1\", \"session_id_2\"],\n     \"plan_name\": \"plan-name\",\n     \"worktree_path\": \"/absolute/path/to/git/worktree\"\n   }\n   ```\n\n6. **Read the plan file** and start executing tasks according to atlas workflow\n\n## OUTPUT FORMAT\n\nWhen listing plans for selection:\n```\nAvailable Work Plans\n\nCurrent Time: {ISO timestamp}\nSession ID: {current session id}\n\n1. [plan-name-1.md] - Modified: {date} - Progress: 3/10 tasks\n2. [plan-name-2.md] - Modified: {date} - Progress: 0/5 tasks\n\nWhich plan would you like to work on? (Enter number or plan name)\n```\n\nWhen resuming existing work:\n```\nResuming Work Session\n\nActive Plan: {plan-name}\nProgress: {completed}/{total} tasks\nSessions: {count} (appending current session)\nWorktree: {worktree_path}\n\nReading plan and continuing from last incomplete task...\n```\n\nWhen auto-selecting single plan:\n```\nStarting Work Session\n\nPlan: {plan-name}\nSession ID: {session_id}\nStarted: {timestamp}\nWorktree: {worktree_path}\n\nReading plan and beginning execution...\n```\n\n## CRITICAL\n\n- The session_id is injected by the hook - use it directly\n- Always update boulder.json BEFORE starting work\n- If worktree_path is set in boulder.json, all work happens inside that worktree directory\n- Read the FULL plan file before delegating any tasks\n- Follow atlas delegation protocols (7-section format)\n\n## TASK BREAKDOWN (MANDATORY)\n\nAfter reading the plan file, you MUST decompose every plan task into granular, implementation-level sub-steps and register ALL of them as task/todo items BEFORE starting any work.\n\n**How to break down**:\n- Each plan checkbox item (e.g., `- [ ] Add user authentication`) must be split into concrete, actionable sub-tasks\n- Sub-tasks should be specific enough that each one touches a clear set of files/functions\n- Include: file to modify, what to change, expected behavior, and how to verify\n- Do NOT leave any task vague - \"implement feature X\" is NOT acceptable; \"add validateToken() to src/auth/middleware.ts that checks JWT expiry and returns 401\" IS acceptable\n\n**Example breakdown**:\nPlan task: `- [ ] Add rate limiting to API`\n\u2192 Todo items:\n  1. Create `src/middleware/rate-limiter.ts` with sliding window algorithm (max 100 req/min per IP)\n  2. Add RateLimiter middleware to `src/app.ts` router chain, before auth middleware\n  3. Add rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining) to response in `rate-limiter.ts`\n  4. Add test: verify 429 response after exceeding limit in `src/middleware/rate-limiter.test.ts`\n  5. Add test: verify headers are present on normal responses\n\nRegister these as task/todo items so progress is tracked and visible throughout the session.\n\n## WORKTREE COMPLETION\n\nWhen working in a worktree (`worktree_path` is set in boulder.json) and ALL plan tasks are complete:\n1. Commit all remaining changes in the worktree\n2. **Sync .sisyphus state back**: Copy `.sisyphus/` from the worktree to the main repo before removal.\n   This is CRITICAL when `.sisyphus/` is gitignored - state written during worktree execution would otherwise be lost.\n   ```bash\n   cp -r <worktree-path>/.sisyphus/* <main-repo>/.sisyphus/ 2>/dev/null || true\n   ```\n3. Switch to the main working directory (the original repo, NOT the worktree)\n4. Merge the worktree branch into the current branch: `git merge <worktree-branch>`\n5. If merge succeeds, clean up: `git worktree remove <worktree-path>`\n6. Remove the boulder.json state\n\nThis is the DEFAULT behavior when `--worktree` was used. Skip merge only if the user explicitly instructs otherwise (e.g., asks to create a PR instead).";
+export declare const START_WORK_TEMPLATE = "\u4F60\u6B63\u5728\u5F00\u59CB\u4E00\u4E2A Sisyphus \u5DE5\u4F5C\u4F1A\u8BDD\u3002\n\n## \u8981\u505A\u4EC0\u4E48\n\n1. **\u67E5\u627E\u53EF\u7528\u8BA1\u5212**\uFF1A\u5728 `.sisyphus/plans/` \u4E2D\u641C\u7D22\u7531 Prometheus \u751F\u6210\u7684\u8BA1\u5212\u6587\u4EF6\n\n2. **\u68C0\u67E5\u6D3B\u8DC3\u7684 boulder \u72B6\u6001**\uFF1A\u5982\u679C\u5B58\u5728\uFF0C\u8BFB\u53D6 `.sisyphus/boulder.json`\n\n3. **\u51B3\u7B56\u903B\u8F91**\uFF1A\n   - \u5982\u679C `.sisyphus/boulder.json` \u5B58\u5728\u4E14\u8BA1\u5212\u672A\u5B8C\u6210\uFF08\u5B58\u5728\u672A\u52FE\u9009\u9879\uFF09\uFF1A\n     - \u5C06\u5F53\u524D\u4F1A\u8BDD **\u8FFD\u52A0** \u5230 session_ids \u4E2D\n     - \u7EE7\u7EED\u6267\u884C\u73B0\u6709\u8BA1\u5212\n   - \u5982\u679C\u6CA1\u6709\u6D3B\u8DC3\u8BA1\u5212\u6216\u8BA1\u5212\u5DF2\u5B8C\u6210\uFF1A\n     - \u5217\u51FA\u53EF\u7528\u7684\u8BA1\u5212\u6587\u4EF6\n     - \u5982\u679C\u53EA\u6709\u4E00\u4E2A\u8BA1\u5212\uFF1A\u81EA\u52A8\u9009\u62E9\u5B83\n     - \u5982\u679C\u6709\u591A\u4E2A\u8BA1\u5212\uFF1A\u663E\u793A\u5E26\u6709\u65F6\u95F4\u6233\u7684\u5217\u8868\uFF0C\u8BA9\u7528\u6237\u9009\u62E9\n\n4. **\u521B\u5EFA/\u66F4\u65B0 boulder.json**\uFF1A\n   ```json\n   {\n     \"active_plan\": \"/absolute/path/to/plan.md\",\n     \"started_at\": \"ISO_TIMESTAMP\",\n     \"session_ids\": [\"session_id_1\", \"session_id_2\"],\n     \"plan_name\": \"plan-name\"\n   }\n   ```\n\n5. **\u8BFB\u53D6\u8BA1\u5212\u6587\u4EF6**\u5E76\u6839\u636E Orchestrator Sisyphus \u5DE5\u4F5C\u6D41\u5F00\u59CB\u6267\u884C\u4EFB\u52A1\n\n## \u8F93\u51FA\u683C\u5F0F\n\n\u5217\u51FA\u8BA1\u5212\u4F9B\u9009\u62E9\u65F6\uFF1A\n```\n\u53EF\u9009\u5DE5\u4F5C\u8BA1\u5212\n\n\u5F53\u524D\u65F6\u95F4\uFF1A{ISO timestamp}\n\u4F1A\u8BDD ID\uFF1A{current session id}\n\n1. [plan-name-1.md] - \u4FEE\u6539\u65F6\u95F4\uFF1A{date} - \u8FDB\u5EA6\uFF1A3/10 \u4EFB\u52A1\n2. [plan-name-2.md] - \u4FEE\u6539\u65F6\u95F4\uFF1A{date} - \u8FDB\u5EA6\uFF1A0/5 \u4EFB\u52A1\n\n\u4F60\u60F3\u5904\u7406\u54EA\u4E2A\u8BA1\u5212\uFF1F\uFF08\u8F93\u5165\u7F16\u53F7\u6216\u8BA1\u5212\u540D\u79F0\uFF09\n```\n\n\u6062\u590D\u73B0\u6709\u5DE5\u4F5C\u65F6\uFF1A\n```\n\u6062\u590D\u5DE5\u4F5C\u4F1A\u8BDD\n\n\u6D3B\u8DC3\u8BA1\u5212\uFF1A{plan-name}\n\u8FDB\u5EA6\uFF1A{completed}/{total} \u4EFB\u52A1\n\u4F1A\u8BDD\u6570\uFF1A{count}\uFF08\u6B63\u5728\u8FFD\u52A0\u5F53\u524D\u4F1A\u8BDD\uFF09\n\n\u6B63\u5728\u8BFB\u53D6\u8BA1\u5212\uFF0C\u4ECE\u6700\u540E\u4E00\u4E2A\u672A\u5B8C\u6210\u4EFB\u52A1\u7EE7\u7EED...\n```\n\n\u81EA\u52A8\u9009\u62E9\u5355\u4E2A\u8BA1\u5212\u65F6\uFF1A\n```\n\u5F00\u59CB\u5DE5\u4F5C\u4F1A\u8BDD\n\n\u8BA1\u5212\uFF1A{plan-name}\n\u4F1A\u8BDD ID\uFF1A{session_id}\n\u5F00\u59CB\u65F6\u95F4\uFF1A{timestamp}\n\n\u6B63\u5728\u8BFB\u53D6\u8BA1\u5212\u5E76\u5F00\u59CB\u6267\u884C...\n```\n\n## \u91CD\u8981\u63D0\u793A\n\n- session_id \u7531 hook \u6CE8\u5165 - \u76F4\u63A5\u4F7F\u7528\u5373\u53EF\n- \u59CB\u7EC8\u5728\u5F00\u59CB\u5DE5\u4F5C\u524D\u66F4\u65B0 boulder.json\n- \u5728\u59D4\u6D3E\u4EFB\u4F55\u4EFB\u52A1\u4E4B\u524D\uFF0C\u8BFB\u53D6\u5B8C\u6574\u7684\u8BA1\u5212\u6587\u4EF6\n- \u9075\u5FAA Orchestrator Sisyphus \u7684\u59D4\u6D3E\u534F\u8BAE\uFF087 \u8282\u683C\u5F0F\uFF09";

package/dist/features/builtin-commands/types.d.ts

@@ -1,5 +1,5 @@
 import type { CommandDefinition } from "../claude-code-command-loader";
-export type BuiltinCommandName = "init-deep" | "ralph-loop" | "cancel-ralph" | "ulw-loop" | "refactor" | "start-work" | "stop-continuation" | "handoff" | "remove-ai-slops";
+export type BuiltinCommandName = "init-deep" | "ralph-loop" | "cancel-ralph" | "ulw-loop" | "refactor" | "start-work";
 export interface BuiltinCommandConfig {
     disabled_commands?: BuiltinCommandName[];
 }