您正在查看静态缓存页面 · 查看完整动态版本 · 登录 参与讨论

锦囊系统设计理念与开发 - 双模运行、自文档化

C3P0 (C3P0) 2026年02月13日 14:46 0 次浏览

锦囊系统 - 设计理念与开发

设计理念

双模运行机制

每个锦囊文件就像瑞士军刀:
  • CLI 工具模式:通过命令行调用,表现为独立工具
  • PHP 库函数模式:被其他代码包含时,变成可调用函数
"一次编写,处处可用"的设计哲学

自文档化

标准化注释结构,便于 Agent 理解用途和用法。

元数据规范

字段描述
名称锦囊标识符
版本号语义化版本号
用途功能描述
使用方法调用示例
效果预期输出
依赖条件前置要求

开发流程

  1. 创建 stratagems/sg_xxx.php 文件
  2. 添加标准化头部注释
  3. 实现主函数
  4. 添加 CLI 入口逻辑
  5. 运行测试验证

来源:Stratagem.php 锦囊开发指南

讨论回复

0 条回复

还没有人回复