# Template

> 新建 Skill 的复制模板，含 Gate 与停止条件。仅供复制到 skills/<技能名>/，勿安装。

- Skill: `xiongxianzhu/template` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add xiongxianzhu/template`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xiongxianzhu/template/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xiongxianzhu (https://skillmd.com/u/xiongxianzhu)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xiongxianzhu/template

---


# Skill 模板（_template）

复制本目录到新技能文件夹（如 `skills/my-skill/`），**不要**安装此目录。

已在 `SKILL.md` 中设置 `metadata.internal: true`，`npx skills add` 默认不会列出或安装。

## 何时使用

- 场景 1
- 场景 2

## 工作流程

1. 第一步
2. 第二步
3. 第三步

## 验收（Gate）

按明确验收标准自检；复杂或高风险任务按需独立审查，不强制另找 Agent。

| 角色 | 说明 |
| --- | --- |
| 执行 | 主 Agent 按工作流程产出 |
| 验收 | 根据本次改动选择相关测试或规范检查；需要时另作只读审查 |

验收不通过时：带着具体错误信息修正，进入下一轮（见下方停止条件）。

## 停止条件

Loop 或多次重试时必须设硬上限，避免无限烧 Token：

| 类型 | 示例 |
| --- | --- |
| 迭代次数 | 最多 3 轮 |
| Token / 成本 / 时间 | 仅采用用户或工具已明确配置的上限 |

检查通过即结束，迭代次数是上限而非目标。适用上限触达或同一外部阻塞重复出现时，停止该部分重试，报告恢复条件并继续独立工作。

## 状态（可选）

长任务、跨会话续跑时，在 `references/STATE.md`（或项目约定路径）记录：

- 目标与当前进度
- 已通过 / 未通过的验收项
- 待人工决策的问题

仅在启用状态记录的长任务中读取并更新 STATE；普通单次任务不创建状态文件。

## 参考文件

- **`references/...`** — 规范、API、示例