github.com/Darkatse/TauriTavern (link)

# TauriTavern Agent Skill

本文档记录当前已落地的 Agent Skill 能力。长期开发以本文、`docs/CurrentState/AgentFramework.md`、`docs/Agent/ToolSystem.md` 与 `docs/API/Skill.md` 为准。

## 定义

Skill 是 Agent 按需读取的本地知识包，不是可执行插件，也不是默认注入 prompt 的大段文本。

一个 Skill 是一个目录：

```text
my-skill/
  SKILL.md
  references/
  examples/
  assets/
  scripts/
  agents/tauritavern.json
```

当前要求：

- `SKILL.md` 

---
name: tauritavern-release-humanizer
description: Polish TauriTavern release or TestFlight notes into natural user-facing prose without changing facts, language, or required structure. Use only as the final editing pass for generated release notes.
---

# TauriTavern release humanizer

Edit silently and return only the final release notes.

- Preserve every supported fact, uncertainty boundary, language choice, and required structure.
- Prefer specific behavior and plain verbs over implementation terms.

---
name: tauritavern-testflight-notes
description: Inspect a prepared TauriTavern release range and draft concise public TestFlight What to Test text containing only changes visible under the ios_external_beta policy. Use for automated Stable or Canary public TestFlight distribution.
---

# TauriTavern TestFlight notes

1. Read `.testflight-notes/release-context.md` and use only its previous and current SHAs as the review range. When maintainer-written release notes are present, use them to prioritize test

# `window.__TAURITAVERN__.api.skill` — Skill API

Skill API 用于管理本地 Agent Skill。它不是 Agent run API；Agent 只是 Skill 的消费者之一。

## 入口

```js
await (window.__TAURITAVERN__?.ready ?? window.__TAURITAVERN_MAIN_READY__);

const skill = window.__TAURITAVERN__.api.skill;
```

## 方法

```ts
type TauriTavernSkillApi = {
  list(options?: { scope?: TauriTavernSkillScopeFilter }): Promise<TauriTavernSkillIndexEntry[]>;
  listFiles(options: { scope?: TauriTavernSkillScope; name

---
name: tauritavern-canary-notes
description: Inspect a prepared TauriTavern Canary commit range and write factual, user-facing release notes in Chinese and English. Use for automated Canary release-note drafting after release-context.md has been generated.
---

# TauriTavern Canary notes

1. Read `.canary-notes/release-context.md` and use only its previous and current SHAs as the review range.
2. Inspect the real range with `git log`, `git diff --stat`, `git diff --name-status`, and focused `git diff` ca

# TauriTavern Workspace Guidelines for AI Agent/Chat

## 道：项目哲学

完整说明见 `CONTRIBUTING.md` 的“项目哲学”。下面七条原则用于指导需求分析、设计、实现和评审。遇到取舍时，应结合用户需求、SillyTavern 生态、平台条件和能够验证的事实作出判断。

1. **通用大于特判。** 先判断若干需求是否共享同一语义，优先扩展一处共同机制。真实差异应当清楚保留；缺少共同需求时，不要提前建立万

# `window.__TAURITAVERN__.api.agent` — Agent API

本文档是 Agent Host ABI 当前参考。Run 控制入口属于 Public Contract；明确标注为 Project Contract 的 UI/诊断投影可以随 Agent 实验能力演进，不等同于 Rust 内部 service/repository。

状态：当前已实现 canonical model IR、provider native metadata 保真、provider_state continuation、上下文只读工具、Skill tools、workspace 读改工具循环、前端 dryRun adapter、Agent run history listing、Agent ru