多平台与团队配置

# 1. 启动会话（必须，替代 Hook 自动注入）
/start

# 2. 加载相关规范（推荐，替代 PreToolUse Hook）
/trellis-before-backend-dev    # 后端任务
/trellis-before-frontend-dev   # 前端任务

# 3. 描述任务，AI 开发...

# 4. 手动检查代码质量（替代 Ralph Loop）
/trellis-check-backend         # 后端检查
/trellis-check-frontend        # 前端检查
/trellis-check-cross-layer     # 跨层检查

# 5. 完工清单
/trellis-finish-work

trellis init --codex -u your-name

trellis init --kilo -u your-name

project/
├── AGENTS.md                           # 开放标准（跨工具兼容）
├── .kilocode/
│   ├── rules/                          # 通用规则（所有模式）
│   │   └── trellis-workflow.md         # Trellis 工作流指南
│   ├── rules-code/                     # Code 模式专用规则
│   ├── rules-architect/                # Architect 模式专用规则
│   ├── workflows/                      # 命令（等同于 slash commands）
│   │   ├── start.md                    # /start 等效
│   │   ├── check-backend.md            # /check-backend 等效
│   │   └── finish-work.md              # /finish-work 等效
│   ├── skills/                         # Agent Skills
│   │   └── trellis-dispatch/
│   │       └── SKILL.md
│   ├── mcp.json                        # MCP 服务器配置
│   └── launchConfig.json               # 自动启动配置

# 1. Kilo 通过 .kilocode/rules/ 自动加载 Trellis 规范
# 或运行 workflow 获取完整上下文
/start.md

# 2. 切换到 Orchestrator 模式处理复杂任务
# Kilo 自动拆解任务并分配给 Code/Architect 等模式

# 3. 描述任务，AI 开发...

# 4. 运行检查 workflow
/check-backend.md

# 5. 完工
/finish-work.md

trellis init --kiro -u your-name

project/
├── .kiro/
│   ├── steering/                       # 项目上下文（等同于 CLAUDE.md）
│   │   ├── product.md                  # 产品概述（可自动生成）
│   │   ├── tech.md                     # 技术栈（可自动生成）
│   │   ├── structure.md                # 目录结构（可自动生成）
│   │   └── trellis-workflow.md         # Trellis 工作流指南
│   ├── hooks/                          # Agent Hooks（事件驱动自动化）
│   │   └── check-on-save.kiro.hook     # 保存时自动检查
│   ├── specs/                          # Spec-Driven Development
│   │   └── feature-name/
│   │       ├── requirements.md         # 需求（EARS 格式）
│   │       ├── design.md               # 技术设计
│   │       └── tasks.md                # 实现 checklist
│   ├── prompts/                        # 自定义提示词（命令）
│   ├── agents/                         # 自定义 Agent 配置（CLI）
│   └── settings/
│       └── mcp.json                    # MCP 服务器配置

# 1. Kiro 通过 .kiro/steering/ 自动加载 Trellis 规范
# 无需手动 /start

# 2. 选择 Spec 模式（推荐）或 Vibe 模式
# Spec 模式：自动生成 requirements → design → tasks 三件套
# Vibe 模式：传统自由编码

# 3. 描述任务，AI 按 tasks.md 逐步实现...

# 4. Agent Hooks 在文件保存时自动触发检查
# 也可手动运行 prompt 检查

# 5. 完成后提交代码

# Worktree Configuration for Multi-Agent Pipeline

#───────────────────────────────────────────────────
# Paths
#───────────────────────────────────────────────────

# Worktree 存储目录（相对于项目根目录）
worktree_dir: ../trellis-worktrees

#───────────────────────────────────────────────────
# Files to Copy
#───────────────────────────────────────────────────

# 每个 worktree 需要独立副本的文件
# 这些文件包含敏感信息或需要独立配置
copy:
  - .env                     # 环境变量
  - .env.local               # 本地环境变量
  - .trellis/.developer      # 开发者身份

#───────────────────────────────────────────────────
# Post-Create Hooks
#───────────────────────────────────────────────────

# 创建 worktree 后执行的命令
# 在 worktree 目录中按顺序执行，失败则中止
post_create:
  - pnpm install --frozen-lockfile
  # - npm install
  # - yarn install --frozen-lockfile

#───────────────────────────────────────────────────
# Check Agent Verification (Ralph Loop)
#───────────────────────────────────────────────────

# 验证代码质量的命令
# 配置后，Ralph Loop 运行这些命令 — 全部通过才放行
# 不配置则使用 completion markers 模式
verify:
  - pnpm lint
  - pnpm typecheck
  # - pnpm test

# 查看当前版本
cat .trellis/.version

# 更新到最新版本
trellis update

# 预览更新（不实际应用）
trellis update --dry-run

# 强制覆盖所有文件
trellis update -f

# 跳过所有变更文件
trellis update -s