Method enqueueFile

src/scan-service.ts:537–724

(filePath: string, sourceRoot: string)

  }

  private async enqueueFile(filePath: string, sourceRoot: string): Promise<SkillScanJobResult> {
    const startedAt = this.now();
    this.logSkillScanStart({
      phase: "queue",
      path: filePath,
      sourceRoot,
    });
    this.clearCooldownIfElapsed();
    if (this.isCooldownActive()) {
      const durationMs = this.now() - startedAt;
      this.params.logger.warn("claw-aegis: 冷却期间已跳过 skill 扫描", {
        event: "skill_scan_skipped",
        state: "cooldown",
        path: filePath,
        durationMs,
      });
      this.logSkillScanFinish({
        phase: "queue",
        path: filePath,
        sourceRoot,
        result: "skipped_cooldown",
        durationMs,
      });
      return { status: "skipped-cooldown" };
    }
    if (path.basename(filePath) !== SKILL_SCAN_TARGET_FILENAME) {
      const durationMs = this.now() - startedAt;
      this.logSkillScanResult({
        phase: "queue",
        path: filePath,
        sourceRoot,
        result: "ignored_non_skill_file",
        durationMs,
      });
      this.logSkillScanFinish({
        phase: "queue",
        path: filePath,
        sourceRoot,
        result: "ignored_non_skill_file",
        durationMs,
      });
      return { status: "already-reviewed" };
    }

    let prepared: PreparedSkillFile | null;
    try {
      prepared = await this.prepareSkillFile(filePath, sourceRoot);
    } catch {
      prepared = null;
    }
    if (!prepared) {
      const durationMs = this.now() - startedAt;
      this.logSkillScanResult({
        phase: "queue",
        path: filePath,
        sourceRoot,
        result: "ignored_unreadable",
        durationMs,