# T-Tools

[English](README.en.md)

面向 Rust、React、小程序与 Flutter 项目的 Claude Code plugin。它把 AI 编程拆成一条可执行、可恢复、可验收的工程工作流：

```text Decision -> 技术预研 -> PRD -> 设计 -> 任务 -> 开发 -> 验收 -> Demo -> 发布 ```

T-Tools 适合已经有产品文档、设计、任务拆解、开发、测试和 Demo 交付链路的项目。它的重点不是让模型自由发挥，而是用 skill 编排阶段、用 subagent 分工执行、用 protocol 固化共享契约，并在需要时用 check / accept 阶段收口质量。

推荐先读 [human/structure.md](human/structure.md)，理解 skill、subagent、protocol 如何协同；做需求前可用 [human/speech-template.md](human/speech-template.md) 先口述一遍真实意图。


## 快速上手

前置条件：

- 已按 [安装](#安装) 加载插件 - 目标项目具备 `docs/` 和 `.ai/` 运行时目录 - 已配置 [`context7`](https://github.com/upstash/context7)

最短闭环：

```bash # 产品立项判断 /t-tools:t-decision user-management

# 需要可行性、依赖或成本判断时使用 /t-tools:t-tech-research user-management

# 生成 .ai/prd 与 .ai/user-stories 草稿 /t-tools:t-prd user-management

# PRD 质量检查（可选，推荐高风险需求运行） /t-tools:t-prd-check user-management

# 生成技术设计 /t-tools:t-design user-management

# 设计质量检查（可选，推荐复杂设计运行） /t-tools:t-design-check user-management

# 生成 backend 阶段可执行任务 /t-tools:t-task user-management --phase backend

# 检查任务拆分、顺序和可执行性（可选，推荐复杂任务运行） /t-tools:t-task-check user-management --phase backend

# 按阶段实现与测试 /t-tools:t-run user-management --phase backend

# 运行 Demo/E2E 测试 /t-tools:t-demo-run super-admin

# 最终验收 /t-tools:t-demo-accept super-admin

# 实现和验收后发布正式 PRD / 用户故事 /t-tools:t-prd-publish user-management ```

`t-prd-check`、`t-design-check`、`t-task-check` 是可选质量检查：高风险需求、复杂设计、多人协作、长期维护或 AI 输出明显不稳定时建议运行；简单变更可直接进入下一阶段。`accept` 阶段仍是实现后的验收收口，不属于这三个可选检查。

## 阶段拆分

`t-task`、`t-task-check` 和 `t-run` 都按 phase 推进，其中 `t-task-check` 是可选检查。典型 Web 顺序是 `backend -> frontend -> demo`；按实际交付端可插入 `miniapp` 和/或 `flutter`。

- `backend`：后端接口、数据模型、权限、业务逻辑、后端测试和只读验收。 - `frontend`：React 页面、组件、状态、前端测试和只读验收。 - `miniapp`：小程序页面、平台能力、构建验证和只读验收。 - `flutter`：Flutter View、Riverpod 状态、数据层、单元/widget/integration 测试和只读验收。 - `demo`：基于用户故事维护 Playwright Demo/E2E，并验收真实用户路径。

每个 phase 都先运行 `/t-tools:t-task <feature> --phase <phase>`，随后可按风险选择运行 `/t-tools:t-task-c