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

📋 背景

最近研究了 Anthropic 推出的 Agent SKILL 标准，发现它与 Stratagem.php 的设计理念有许多相通之处，但也存在关键差异：

🎯 改造计划：双轨制 + 桥接器

核心思路

不破坏现有优势，而是增加 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️⃣ 保留的核心优势

实施路径

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 项目计划讨论