001 skill目录结构---软件测试

【skill介绍】
是一套写好的工作流程（SOP），告诉AI在遇到任务时，应该用到什么工具，按什么流程，以什么格式输出结果，而不是每次零理解。Skill=说明书+流程指南+模板+注意事项

1、目录结构
opencode/.opencode/skills/ ---opencode：一级目录
└── test-case-generator/ # skill-name
├── SKILL.md # 必需 - - 推荐做法是将skills放入.opencode/skills/ 目录，这样更规范，也便于与个人全局 Skill 区分
├── config.json # 可选 - 配置文件
└── reference/ # 可选 - 详细文档（参考资源，如业务背景、详细规范说明，如case_format.md、test_design_methods.md -- 测试设计方法参考）

opencode/test-case-generator/ ---opencode：一级目录
└── scripts/ # 可选 - 工具脚本
└── requirements/ # 可选 - 输入文件
└── output/ # 可选 - 输出格式模板

opencode/test-results/ ---opencode：一级目录

2、skill格式

2.1 关键要点
name：最多64字符，仅小写字母/数字/连字符
description：最关键的部分，决定 Agent 何时自动触发该 Skill，需包含做什么和何时用
SKILL.md 控制在 500 行以内，详细内容放到 reference 文件
简洁为王：Agent 本身很聪明，只写它不知道的领域知识

2.2 常用模式
模板模式：提供输出格式模板
示例模式：给出输入→输出的具体示例
工作流模式：分步骤 + checklist 引导
脚本模式：提供预写好的工具脚本，比生成代码更可靠

2.3 避免的反模式
❌ Windows 风格路径（用 / 不用 \）
❌ 提供太多可选方案（给一个默认方案 + 备选）
❌ 时间敏感信息
❌ 术语不统一
❌ 模糊的命名（如 helper、utils）