内容
# KAEDE — Koneksi Automated Environment DE
**Trello Power-Up** + **CLI 工具** 用于连接 Trello 团队规划与 AI Agent 生态系统。
| | |
|---|---|
| **Power-Up** | [`kaede-powerup.netlify.app`](https://kaede-powerup.netlify.app) |
| **文档** | [`konxc.github.io/kaede-powerup`](https://konxc.github.io/kaede-powerup) |
| **仓库** | `github.com/konxc/kaede-powerup` |
| **技术栈** | Tailwind CSS v4 + Bun |
| **许可证** | 专有 — PT Koneksi Jaringan Indonesia |
---
## 功能
### Trello Power-Up
- **环境管理器** — 为每个 Trello 卡片设置 Production/Staging/Development 标签
- **仪表盘** — 查看每个板块的环境统计信息
- **卡片徽章** — 环境状态直接显示在卡片上
- **授权** — 与部署提供商的安全连接
### CLI 工具 (`kaede`)
- **`kaede setup`** — 交互式设置 Trello API 密钥和令牌
- **`kaede today`** — 查看今天分配的 Trello 任务
- **`kaede init`** — 在项目中初始化 KAEDE（配置 MCP Trello）
- **`kaede env`** — 将凭证导出为环境变量
- **`kaede status`** — 检查配置状态
### MCP 集成
- **MCP Trello 服务器** — AI Agent 可以直接读取/写入 Trello
- **自动包装器** — 从 `secrets.env` 读取凭证，无需手动环境变量
- **中立** — 可用于 Laravel、Node.js、Python 等项目
---
## 仓库结构
```
├── public/ # 静态网站（部署到 Netlify）
│ ├── index.html # 登陆页面 + iframe 连接器（Trello）
│ ├── board.html # 仪表盘弹窗
│ ├── card.html # 卡片环境管理器
│ ├── auth.html # 授权页面
│ ├── privacy.html # 隐私政策
│ ├── js/kaede.js # Power-Up 功能
│ ├── css/style.css # 编译后的 CSS（自动生成）
│ └── _redirects # Netlify 重定向规则
├── src/
│ ├── mcp-server.js # MCP Trello 服务器（源代码）
│ └── style.css # 源代码 CSS（Tailwind v4 + 自定义组件）
├── dist/
│ └── mcp-server.js # MCP Trello 服务器（编译后，--target bun）
├── scripts/
│ ├── kaede.mjs # CLI 工具（setup、today、init、push、env、status）
│ ├── build-docs.mjs # 构建文档：Markdown → HTML
│ └── build-mcp.mjs # 通过 bun build 编译 MCP 服务器
├── netlify.toml # Netlify 部署配置
├── package.json # 构建脚本和入口点
│
├── docs/ # 文档（来源：Markdown）
│ ├── index.md # 概述
│ ├── api-key.md # Trello API 密钥和令牌指南
│ ├── mcp-server.md # Trello MCP 服务器设置
│ ├── opencode.md # OpenCode 集成
│ ├── tools.md # MCP 工具参考
│ ├── role-management.md # 角色定义和 AI Agent 集成
│ ├── kaede-architecture.md # 架构和路线图
│ └── playbook-template.md # 通用剧本模板
│
├── .opencode/
│ ├── opencode.json # AI Agent 配置
│ └── SHARED/ # 项目上下文和代理规则
│
├── netlify.toml # Netlify 部署配置
├── package.json # 构建脚本和 CLI 入口点
├── scripts/
│ ├── kaede.mjs # CLI 工具（setup、today、init、push、env、status）
│ └── build-docs.mjs # 构建文档：Markdown → HTML
├── secrets.env # Trello 凭证（gitignored）
```
---
## 快速开始
### 1. 设置凭证
```bash
# 交互式 — 输入 Trello API 密钥和令牌
node scripts/kaede.mjs setup
```
或者手动创建 `secrets.env`：
```env
TRELLO_API_KEY=your-api-key
TRELLO_TOKEN=your-token
```
### 2. 查看今日任务
```bash
node scripts/kaede.mjs today
```
### 3. 在其他项目中初始化
```bash
# 从目标项目内部
node path/to/kaede/scripts/kaede.mjs init .
```
这将为您的项目添加 MCP Trello 配置到 `.opencode/opencode.json`。
### 4. 与 OpenCode 集成
KAEDE 已准备好与 OpenCode 配合使用。MCP Trello 通过包装器配置，该包装器自动从 `secrets.env` 读取凭证 — 无需手动设置环境变量。
```bash
# 检查配置状态
node scripts/kaede.mjs status
# 将凭证导出到会话（PowerShell）
node scripts/kaede.mjs env | iex
# 将凭证导出到会话（Bash）
eval $(node scripts/kaede.mjs env)
```
---
## 开发
```bash
# 安装依赖
bun install
# 开发（CSS 监听 + 静态服务器）
bun run dev
# 构建生产 CSS
bun run build
# 预览
bun run preview
```
### KAEDE CLI（开发）
```bash
bun run kaede -- setup
bun run kaede -- today
bun run kaede -- status
```
---
## 部署
### Netlify（Power-Up）
推送到 `main` → Netlify 自动部署：
- **分支：** `main`
- **发布目录：** `public`
- **构建命令：** `bun run build`
- **网址：** `kaede-powerup.netlify.app`
### GitHub Pages（文档）
`docs/*.md` 中的文档通过 GitHub Actions 自动构建到 `gh-pages` 分支：
- **网址（默认）：** `konxc.github.io/kaede-powerup`
- **网址（目标）：** `konxc.github.io/kaede`（重命名仓库 → `kaede`）
---
## 技术栈
| 技术 | 版本 |
|---|---|
| [Tailwind CSS](https://tailwindcss.com) | v4 |
| [Bun](https://bun.sh) | v1 |
| [delorenj/mcp-server-trello](https://github.com/delorenj/mcp-server-trello) | v1.6.1+ |
| [Marked](https://marked.js.org) | 构建时 |
| [peaceiris/actions-gh-pages](https://github.com/peaceiris/actions-gh-pages) | v4 |
---
## 谁需要 KAEDE？
| 角色 | 主要好处 |
|---|---|
| **项目经理** | 通过意图进行 sprint 自动化 — “开始 Alpha sprint” 一条命令 |
| **开发人员** | 44 种 MCP 工具、剪贴板到卡片附件、`kaede today` |
| **QA / 测试人员** | 模板检查清单、卡片历史记录、按到期日期排序 |
| **技术负责人** | 强制执行的剧本治理、双 MCP 架构 |
| **利益相关者** | 卡片上的环境徽章、零配置 |
| **AI 工程师** | 可扩展的 MCP 服务器、通过 PR 进行上游贡献 |
完整文档：[`docs/sdlc-roles.md`](docs/sdlc-roles.md)（英文） | [`docs/id/sdlc-roles.md`](docs/id/sdlc-roles.md)（中文）
---
## 支持开发
KAEDE 由 **Sandiko** 作为 PT Koneksi Jaringan Indonesia 的内部开源项目开发。如果此工具对您有帮助，请支持后续开发：
[](https://trakteer.id/sandikodev)
每种支持方式都意味着 — 从一杯咖啡到代码贡献。
---
## 生态系统
KAEDE 是 PT Koneksi Jaringan Indonesia 开发生态系统的一部分：
```
剧本 → OpenKB → OpenCode → KAEDE → Trello
(SOP) (知识库) (AI 代理) (桥梁) (板块)
```
- **剧本** — 人类到人类的指南（SOP，工作流程）
- **OpenKB** — 知识库（AI ↔ 人类通信）
- **OpenCode** — AI 代理配置
- **KAEDE** — Trello 桥梁 ↔ MCP
---
## 许可证
专有 — © 2026 PT Koneksi Jaringan Indonesia.
KAEDE 可用于内部项目，但商业重新分发未经许可是不允许的。
