Config paths → Workspace → Global → Bundled

// 核心加载函数来自 pi-coding-agent 包
import { loadSkillsFromDir } from '@mariozechner/pi-coding-agent';

// 加载技能目录
const skills = await loadSkillsFromDir(skillDir);

// 注册通道
api.registerChannel(config: ChannelConfig);

// 注册工具
api.registerTool(name: string, handler: ToolHandler);

// 注册 Gateway 方法
api.registerGatewayMethod(method: string, handler: Function);

// 来自 src/agents/skills/refresh.ts
const watcher = chokidar.watch(watchTargets, {
  ignoreInitial: true,
  awaitWriteFinish: {
    stabilityThreshold: debounceMs,
    pollInterval: 100,
  },
  ignored: DEFAULT_SKILLS_WATCH_IGNORED,
});

interface PluginSDK {
  // 后台服务
  Background: {
    start(service: BackgroundService): void;
    stop(serviceId: string): void;
  };

  // 生命周期钩子
  Lifecycle: {
    on(event: LifecycleEvent, handler: Function): void;
  };

  // 配置管理
  Config: {
    get<T>(key: string): T;
    set<T>(key: string, value: T): void;
  };

  // 日志
  Logger: {
    info(msg: string): void;
    error(msg: string): void;
    debug(msg: string): void;
  };
}

#!/bin/bash
# preprocess-skills.sh
node scripts/modify-skills.js
openclaw start  # 启动 OpenClaw

// scripts/modify-skills.js
const fs = require('fs');
const path = require('path');
const yaml = require('yaml');

const skillPath = process.env.SKILL_PATH || './skills/my-skill/SKILL.md';
const content = fs.readFileSync(skillPath, 'utf8');

// 解析 frontmatter
const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
if (match) {
  const frontmatter = yaml.parse(match[1]);
  const body = match[2];

  // 动态修改内容
  frontmatter.lastModified = new Date().toISOString();
  frontmatter.dynamicValue = calculateDynamicValue();

  // 写回文件
  const newContent = `---\n${yaml.stringify(frontmatter)}---\n${body}`;
  fs.writeFileSync(skillPath, newContent);
}

// 在你的插件中
import { definePlugin } from 'openclaw';

export default definePlugin({
  name: 'dynamic-skill-modifier',

  hooks: {
    // 在构建 prompt 之前修改 skill 内容
    before_prompt_build: async ({ skills, context }) => {
      // 动态修改 skill 对象（不修改文件，只修改内存中的表示）
      for (const skill of skills) {
        if (skill.name === 'my-dynamic-skill') {
          skill.content = modifySkillContent(skill.content, context);
        }
      }
      return { skills };
    }
  }
});

// plugins/dynamic-skill-loader.ts
import { loadSkillsFromDir } from 'pi-coding-agent';
import * as fs from 'fs';
import * as path from 'path';

export class DynamicSkillLoader {
  async loadSkills(skillDir: string) {
    // 1. 复制 skill 到临时目录
    const tempDir = this.createTempCopy(skillDir);

    // 2. 修改临时目录中的 SKILL.md
    this.modifySkillMdFiles(tempDir);

    // 3. 从临时目录加载
    return loadSkillsFromDir(tempDir);
  }

  private modifySkillMdFiles(dir: string) {
    const skillMdFiles = this.findSkillMdFiles(dir);
    for (const file of skillMdFiles) {
      let content = fs.readFileSync(file, 'utf8');

      // 动态修改内容
      content = this.applyDynamicModifications(content);

      fs.writeFileSync(file, content);
    }
  }

  private applyDynamicModifications(content: string): string {
    // 添加动态生成的内容
    const dynamicSection = `\n\n<!-- 动态生成于 ${new Date().toISOString()} -->\n`;
    return content + dynamicSection;
  }
}

// 在你的构建脚本中
import * as chokidar from 'chokidar';
import * as fs from 'fs';

// 监听原始 skill 定义文件
const watcher = chokidar.watch('./skill-sources/**/*.md');

watcher.on('change', (filepath) => {
  console.log(`Source changed: ${filepath}`);

  // 重新生成 SKILL.md
  generateSkillMd(filepath);
});

function generateSkillMd(sourcePath: string) {
  const source = fs.readFileSync(sourcePath, 'utf8');

  // 动态生成 frontmatter
  const frontmatter = {
    name: extractName(source),
    version: calculateVersion(),
    lastBuild: new Date().toISOString(),
    dynamicConfig: loadDynamicConfig()
  };

  // 写入 SKILL.md（触发 OpenClaw 重载）
  const skillMd = `---\n${yaml.stringify(frontmatter)}---\n${extractBody(source)}`;
  fs.writeFileSync('./skills/my-skill/SKILL.md', skillMd);
}