{Skill 中文标题}

{skill 是什么，产出什么。}

能力特性：

• {能力点 1}
• {能力点 2}
• {能力点 3}

适用范围与限制

• 适用：{如 Hi3516CV610 / Hi3516CV608 平台的 …… 场景}
• 不适用：{相邻但不该用本 skill 的场景，指向正确的 skill}
• 已知限制：{如 仅保证 CV610，其他平台不保证 / 当前目录需为已编译的 SDK 工程}

目录结构

{skill-name}/
├── SKILL.md          # Agent 运行指令
├── README.md         # 本文件
├── scripts/          # 可执行脚本
├── references/       # 细节文档（步骤展开、模板、清单、FAQ）
└── examples/         # 输入 / 输出示例

前置依赖

依赖	安装 / 配置方式
{依赖名称，如 gitcode CLI}	{安装命令或配置步骤}
{环境变量，如 GITCODE_TOKEN}	export {VAR}={value}

验证：运行 {检查命令} 确认所有依赖就绪。

支持的 AI Coding 平台：{如 Claude Code / Opencode / …（按需）}

安装 / 启用

本仓 skill 位于 <工程>/.agents/skills/{skill-name}/，随仓库一起分发。

如需在其他工程复用，将整个 {skill-name}/ 目录复制到目标工程的 skills 目录下。

使用场景

触发场景	示例
{功能}	"{prompt}"

{场景名称}

触发 prompt：

{用户对 AI 说的自然语言}

等价命令（可选）：

/{skill-name} {参数}

{场景名称}

触发 prompt：

{用户对 AI 说的自然语言}

输入 / 输出

• 输入：{运行前用户须提供的信息或文件，逐项列出并标注 必需 / 可选}
• 输出：{产物相对路径} — {格式与包含内容的简要说明}

执行流程

展开执行流程

| 阶段 | 内容 | 说明 | |------|------|------| | {阶段名} | {动作} | {补充说明} |

附录

故障排查

现象	处理
{错误信息}	{解决方法}

相关文档

• [{文档标题}](references/{xxx}.md)