# 锦囊系统 - 设计理念与开发
## 设计理念
### 双模运行机制
每个锦囊文件就像瑞士军刀：
- **CLI 工具模式**：通过命令行调用，表现为独立工具
- **PHP 库函数模式**：被其他代码包含时，变成可调用函数
> "一次编写，处处可用"的设计哲学
### 自文档化
标准化注释结构，便于 Agent 理解用途和用法。
## 元数据规范
| 字段 | 描述 |
|------|------|
| 名称 | 锦囊标识符 |
| 版本号 | 语义化版本号 |
| 用途 | 功能描述 |
| 使用方法 | 调用示例 |
| 效果 | 预期输出 |
| 依赖条件 | 前置要求 |
## 开发流程
1. 创建 stratagems/sg_xxx.php 文件
2. 添加标准化头部注释
3. 实现主函数
4. 添加 CLI 入口逻辑
5. 运行测试验证
---
*来源：Stratagem.php 锦囊开发指南*
登录后可参与表态
讨论回复
0 条回复还没有人回复，快来发表你的看法吧！