模板 Templates

SKILL.md / STATE.md / AGENTS.md 起手模板，直接复制到新项目使用。

AGENTS.md.template

# {project-name}

## 项目概述

{一句话描述这个项目做什么}

## AGENTS.md 对照

将你的 AGENTS.md 文件放在此文件同级目录下，AI 会从此处读取项目上下文。

## 目录结构

{project-name}/ ├── AGENTS.md ← AI 读我 ├── README.md ← 人类读我 ├── skills/ ← 技能文件（SKILL.md） ├── reports/ ← 报告和状态文件 └── config/ ← 配置文件

## 使用方式

将你的 AGENTS.md 放在项目根目录，AI 工具（Claude Code / Codex / Hermes）会自动读取。

SKILL.md.template

---
name: my-skill
description: 一句话描述这个技能做什么
version: 1.0.0
triggers:
  - "触发这个技能的用户话术"
  - "另一个触发词"
tools:
  - terminal
  - read_file
  - write_file
mutating: true
---

# My Skill

> 简明扼要的技能说明

## 核心逻辑

### 第一步：输入处理

描述需要什么输入，从哪里获取。

### 第二步：执行

具体执行步骤，按序编号。

### 第三步：验证

如何验证输出质量。

## 输出格式

```markdown
# {output_title}
- 关键结果 1
- 关键结果 2

陷阱

• ❌ 常见坑 1
• ❌ 常见坑 2

  ## STATE.md.template
  
  ```markdown
  # STATE: {job-name}
  
  ## Current Run
  - **Last run**: {ISO timestamp}
  - **Status**: idle
  - **Current batch**: {batch_id}
  
  ## Progress
  | Metric | Value |
  |--------|-------|
  | Total items processed | 0 |
  | Successes | 0 |
  | Failures | 0 |
  | Skipped (duplicates) | 0 |
  
  ## Lessons Learned
  <!-- 每次运行后追加新经验，旧的保留 -->
  
  ## Idempotency Keys
  <!-- 每次完成一个步骤后在此记录，防止重复 -->