name: trellis-bootstrap description: 在项目中初始化 Trellis AI 工作流系统。当用户提到 “Trellis”、“初始化 Trellis”、“setup Trellis”、“install Trellis”，或想要添加 AI 辅助开发工作流到他们的项目时使用。这是一个一次性设置技能。 allowed-tools: Bash, Read, AskUserQuestion

Trellis 引导程序

Trellis 的一次性设置 - 这是一个 AI 工作流系统，帮助您的 AI 助理跨会话记住项目上下文。

什么是 Trellis？

Trellis 提供：

结构 - 在 .trellis/structure/ 中存储编码指南，AI 会遵循
记忆 - 在 .trellis/agent-traces/ 中跟踪会话历史
自动化 - 斜杠命令如 /start、/parallel、/finish-work

前提条件检查

开始前，验证：

# 检查 Node.js（要求：v18+）
node --version

# 检查 npm
npm --version

如果 Node.js 未安装，请先要求用户安装。

安装步骤

步骤 1：安装 Trellis CLI

npm install -g @mindfoldhq/trellis@latest

验证安装：

trellis --version

步骤 2：获取开发者名称

询问用户的姓名/用户名。这将用于跟踪他们的会话。

示例问题：“我应该使用什么名称作为您的开发者配置文件？（例如，您的 GitHub 用户名）”

步骤 3：在项目中初始化

在项目根目录运行：

trellis init -u <developer-name>

这会创建：

.trellis/
├── workflow.md                # 从这里开始
├── structure/                 # 开发指南
│   ├── frontend/
│   └── backend/
├── agent-traces/<name>/       # 您的会话历史
└── scripts/                   # 自动化脚本

.claude/
├── commands/                  # 13 个斜杠命令
├── agents/                    # 6 个代理定义
└── hooks/                     # 自动化钩子

.cursor/
└── commands/                  # 12 个斜杠命令

AGENTS.md                      # AI 首先读取此文件

步骤 4：验证设置

# 检查创建的文件
ls -la .trellis/
ls -la .claude/commands/

安装后说明

告诉用户：

开始使用 Trellis - 在每个会话开始时运行 /start
添加指南 - 编辑 .trellis/structure/ 中的文件以自定义 AI 行为
跟踪进度 - 在会话结束时运行 /record-agent-flow

快速参考

命令	使用时机
`/start`	每个会话的开始
`/parallel`	复杂功能（多代理管道）
`/before-frontend-dev`	前端编码前
`/before-backend-dev`	后端编码前
`/finish-work`	提交前
`/record-agent-flow`	会话结束时

成功标准

设置完成当：

[ ] trellis --version 显示版本号
[ ] .trellis/ 目录存在且包含 workflow.md
[ ] .claude/commands/ 包含斜杠命令文件
[ ] AGENTS.md 存在于项目根目录

成功设置后，此技能不再需要。用户应使用 /start 开始与 Trellis 合作。

注意：这是一个引导技能。一旦 Trellis 初始化完成，请使用内置的 /start 命令代替此技能。