Skip to content

Latest commit

 

History

History
108 lines (84 loc) · 5.82 KB

README.zh-CN.md

File metadata and controls

108 lines (84 loc) · 5.82 KB

tea-stack

English | 简体中文

一套面向 Claude Code、Codex、Antigravity (agy)、Cursor 和 Kimi Code 的轻量、低 Token 税生产研发工作流插件。

如果你觉得重型 Agent 框架流程太繁琐、日常改动仪式感太重或 Token 消耗过高,tea-stack 只保留真正守住生产代码质量下限的最小闭环:~4 KB 精简基线 + 5 个聚焦 Skill + 1 个只读独立审查员,10 秒装完即可上手。

为什么做 tea-stack?

  • 按风险伸缩,低仪式感:明确小改动直接做完验证;跨模块、改契约或高风险任务才启用计划与独立审查,不打断开发节奏。
  • 低 Token 税,不触发截断:全局基线仅 ~4 KB,单个 Skill 仅 1.5–3 KB 按需加载,远离宿主规则截断红线。
  • 把“写与审隔离”做成开箱能力:内置只读 code-reviewer sub-agent,让关键改动天然在独立上下文里做证据化 P0/P1/P2 审查。
  • 原生五端一键安装:单个干净仓库同时原生支持 Claude Code、Codex、Antigravity、Cursor、Kimi Code,并附零副作用软链脚本兜底。

10 秒快速安装

Claude Code

/plugin marketplace add futuretea/tea-stack
/plugin install tea-stack@tea-stack

Antigravity (agy)

agy plugin install https://github.com/futuretea/tea-stack

Codex

codex plugin marketplace add https://github.com/futuretea/tea-stack.git
codex plugin add tea-stack@tea-stack

(或使用脚本软链安装:./install.sh --target codex)

Cursor

/add-plugin https://github.com/futuretea/tea-stack

(或使用脚本软链安装:./install.sh --target cursor)

Kimi Code

  • TUI 插件管理:在 Kimi Code 内输入 /plugins,通过 https://github.com/futuretea/tea-stack.git 安装(读取 kimi.plugin.json)。
  • CLI Skills 目录:直接通过 kimi --skills-dir /path/to/tea-stack/skills 加载,或运行 ./install.sh --target kimi 建立一次软链。

通用软链脚本(macOS / Linux — 任意 Agent)

# 预览软链动作,不做任何修改
./install.sh --target all --dry-run

# 支持目标:claude | codex | cursor | kimi | all
./install.sh --target kimi

# 或安装到任意自定义 Skills 目录
./install.sh --skills-dir ~/.config/agents/skills

install.sh 仅对 skills/* 建立软链,遇到已有文件或软链会自动跳过,不会覆盖你现有的全局 AGENTS.md / CLAUDE.md。

核心工作流

需求 / 任务
  │
  ├─ 跨模块 / 契约变更 / 高风险 ──▶ write-plan(先对齐范围与验证方式)
  │                                    │
  └─ 明确小改动 ───────────────────────┴──▶ 编码实现 + 运行测试
                                               │
                         遇到异常 / 失败 ◀─────┤
                                │              │
                              debug            ▼
                                         review-code(独立会话 / code-reviewer)
                                               │
                                               ▼
                                         feature-ready(门禁体检 + PR 摘要)

仓库内容

路径 用途
skills/using-tea-stack/SKILL.md 轻量工作流路由与 5 条不可违反的生产红线
skills/write-plan/SKILL.md 跨模块或契约改动前的一页纸可执行实现计划
skills/debug/SKILL.md 科学方法排障:复现 → 假说 → 控制变量取证 → 最小根因修复
skills/review-code/SKILL.md 独立视角、证据驱动的 P0/P1/P2 代码审查
skills/feature-ready/SKILL.md 提 PR / 交测前的交付体检与 PR 摘要草稿
agents/code-reviewer.md 只读独立代码审查 sub-agent 定义
rules/AGENTS.md 精简全局规则基线(~4 KB;Antigravity 插件自动加载,其余工具可按需合入)
templates/PROJECT-AGENTS.md 放到业务仓库根目录的 150 行内 AGENTS.md / CLAUDE.md 模板
examples/ 填好的项目 AGENTS.md 样例 + 证据驱动 Review 输出样例
docs/TEAM-PLAYBOOK.zh-CN.md 团队落地指南、常见翻车模式与两周试点方案(English)

内置五端插件清单

在具体项目中落地

  1. 按上面对应工具的命令安装 tea-stack 插件。
  2. 将 templates/PROJECT-AGENTS.md 复制到你的业务仓库根目录,改名为 AGENTS.md(或 CLAUDE.md),花 10 分钟填好构建/测试/Lint 命令(参考 examples/project-agents-example.md)。
  3. 按需把 rules/AGENTS.md 中认同的条款合入你的全局规则文件。

License

MIT