[计划] Stratagem.php 双轨制改造：成为 MCP 与 Anthropic SKILL 的桥梁

## 📋 背景 最近研究了 Anthropic 推出的 **Agent SKILL** 标准，发现它与 Stratagem.php 的设计理念有许多相通之处，但也存在关键差异： | 维度 | Stratagem.php (现状) | Anthropic SKILL (标准) | |------|---------------------|------------------------| | 形态 | 单个 PHP 文件 | 文件夹 + SKILL.md | | 元数据 | PHPDoc 注释头部 | YAML Frontmatter | | 核心内容 | PHP 函数 + CLI 入口 | Markdown 工作流指令 | | 渐进加载 | ❌ 无 | ✅ 三级披露 | | Token 成本 | 中等（单文件） | 低（按需加载） | | 生态 | MCP 生态 | agentskills.io 生态 | ## 🎯 改造计划：双轨制 + 桥接器 ### 核心思路 **不破坏现有优势，而是增加 SKILL 兼容层**，让项目成为两个生态的桥梁。 ### 架构设计 ``` ┌───────────────────┐ ┌───────────────────┐ │ 原生的 PHP 锦囊 │◄────►│ SKILL 格式锦囊 │ │ (sg_xxx.php) │ 双向 │ (skill-name/) │ └─────────┬─────────┘ 转换 └─────────┬─────────┘ │ │ └──────────┬───────────────┘ ▼ ┌─────────────────────┐ │ sg_skill_bridge │ ← 核心新增组件 │ (格式转换桥接器) │ │ │ │ • php2skill() │ PHP → SKILL │ • skill2php() │ SKILL → PHP │ • sync() │ 双向同步 │ • validate() │ 格式验证 └─────────────────────┘ ``` ### 具体改造方案 #### 1️⃣ 新增 SKILL 兼容层（不破坏现有代码） ``` stratagem.php/ ├── stratagems/ # 原 PHP 锦囊（保持不变） ├── skills/ # 【新增】SKILL 格式锦囊目录 │ ├── base64/ │ │ ├── SKILL.md │ │ └── references/ ├── src/ │ ├── SkillBridge.php # 【新增】格式转换核心类 │ ├── SkillImporter.php # 【新增】SKILL 导入器 │ └── SkillExporter.php # 【新增】SKILL 导出器 ``` #### 2️⃣ 双向转换规则 **PHP 锦囊 → SKILL：** - 提取 PHPDoc 元数据转换为 YAML Frontmatter - PHP 函数封装为 Markdown 代码示例 - 保留 `source` 字段指向原 PHP 文件 **SKILL → PHP 锦囊：** - 提取 SKILL.md 中的代码示例 - 将 scripts/ 中的逻辑封装为 PHP 函数 - 生成 CLI 入口，保持双模运行特性 #### 3️⃣ 保留的核心优势 | 现有优势 | 改造后保留方式 | |---------|--------------| | **双模运行** | 生成 SKILL 时保留 `source` 字段指向原 PHP 文件 | | **FTS5 搜索** | 扩展索引同时覆盖 `skills/*` 目录 | | **≤500 tokens** | SKILL 的渐进披露天然支持 | | **MCP 协议** | 原 `stratagem` tool 保留，新增 `skill/*` tools | ### 实施路径 ``` Phase 1: 基础设施（1-2 天） ├── 创建 SkillBridge 核心类 ├── 实现 php2skill() 单向转换 └── 新增 skills/ 目录结构 Phase 2: 双向同步（2-3 天） ├── 实现 skill2php() 反向转换 ├── 建立同步机制（修改自动同步） └── 添加格式验证 Phase 3: MCP 集成（1-2 天） ├── 注册新的 skill_* tools ├── 实现渐进式披露逻辑 └── 测试与现有工具共存 Phase 4: 生态互通（可选） ├── 发布到 agentskills.io ├── 导入第三方 SKILL └── 提供一键转换 CLI ``` ## 🤔 期待大家的想法 1. 你认为这个双轨制架构是否有价值？ 2. 作为 PHP 锦囊的使用者，你会选择使用 SKILL 格式吗？ 3. 有没有其他生态整合的建议？ 欢迎讨论！ --- *发布自 Stratagem.php 项目计划讨论*