附录 A：关键文件路径速查
核心文档
| 文件 | 说明 | 何时读取 |
|---|---|---|
.trellis/workflow.md | 开发工作流指南 | 每次会话启动 |
.trellis/worktree.yaml | Multi-Agent worktree 配置 | 并行开发时 |
.trellis/.version | 当前 Trellis 版本 | 更新时 |
命令定义
| 文件 | 命令 |
|---|---|
.claude/commands/trellis/start.md | /start |
.claude/commands/trellis/parallel.md | /parallel |
.claude/commands/trellis/record-session.md | /record-session |
.claude/commands/trellis/finish-work.md | /finish-work |
.claude/commands/trellis/onboard.md | /onboard |
.claude/commands/trellis/before-backend-dev.md | /before-backend-dev |
.claude/commands/trellis/before-frontend-dev.md | /before-frontend-dev |
.claude/commands/trellis/check-backend.md | /check-backend |
.claude/commands/trellis/check-frontend.md | /check-frontend |
.claude/commands/trellis/check-cross-layer.md | /check-cross-layer |
.claude/commands/trellis/break-loop.md | /break-loop |
.claude/commands/trellis/create-command.md | /create-command |
.claude/commands/trellis/integrate-skill.md | /integrate-skill |
Agent 定义
| 文件 | Agent | 角色 |
|---|---|---|
.claude/agents/dispatch.md | Dispatch | 纯调度器 |
.claude/agents/plan.md | Plan | 需求评估 |
.claude/agents/implement.md | Implement | 代码实现 |
.claude/agents/check.md | Check | 质量检查 |
.claude/agents/debug.md | Debug | Bug 修复 |
.claude/agents/research.md | Research | 信息搜索（只读） |
Hook 脚本
| 文件 | 触发时机 | 功能 |
|---|---|---|
.claude/hooks/session-start.py | SessionStart | 自动注入上下文 |
.claude/hooks/inject-subagent-context.py | PreToolUse (Task) | 规范注入引擎 |
.claude/hooks/ralph-loop.py | SubagentStop (check) | 质量控制循环 |
Cursor 命令定义
| 文件 | 命令 |
|---|---|
.cursor/commands/trellis-start.md | /trellis-start |
.cursor/commands/trellis-before-backend-dev.md | /trellis-before-backend-dev |
.cursor/commands/trellis-before-frontend-dev.md | /trellis-before-frontend-dev |
.cursor/commands/trellis-check-backend.md | /trellis-check-backend |
.cursor/commands/trellis-check-frontend.md | /trellis-check-frontend |
.cursor/commands/trellis-check-cross-layer.md | /trellis-check-cross-layer |
.cursor/commands/trellis-finish-work.md | /trellis-finish-work |
.cursor/commands/trellis-record-session.md | /trellis-record-session |
.cursor/commands/trellis-break-loop.md | /trellis-break-loop |
.cursor/commands/trellis-onboard.md | /trellis-onboard |
.cursor/commands/trellis-create-command.md | /trellis-create-command |
.cursor/commands/trellis-integrate-skill.md | /trellis-integrate-skill |
Codex / OpenCode 配置
| 文件 | 说明 |
|---|---|
AGENTS.md | Codex 入口文件，提供项目基础上下文 |
.agents/skills/ | Agent Skills 目录（Codex / OpenCode 共用） |
Kilo Code 配置
| 文件 | 说明 |
|---|---|
.kilocode/rules/*.md | 项目规则（所有模式通用） |
.kilocode/rules-code/*.md | Code 模式专用规则 |
.kilocode/rules-architect/*.md | Architect 模式专用规则 |
.kilocode/workflows/*.md | Workflow 命令（等同于 slash commands） |
.kilocode/skills/*/SKILL.md | Agent Skills（YAML frontmatter + 指令） |
.kilocode/launchConfig.json | 自动启动配置 |
.kilocode/mcp.json | MCP 服务器配置 |
Kiro 配置
| 文件 | 说明 |
|---|---|
.kiro/steering/*.md | Steering 文件（项目上下文，自动加载） |
.kiro/hooks/*.kiro.hook | Agent Hooks（JSON 格式，事件驱动自动化） |
.kiro/specs/*/requirements.md | Spec 需求文档（EARS 格式） |
.kiro/specs/*/design.md | Spec 技术设计文档 |
.kiro/specs/*/tasks.md | Spec 实现任务 checklist |
.kiro/prompts/ | 自定义提示词 |
.kiro/agents/ | 自定义 Agent 配置（CLI） |
.kiro/settings/mcp.json | MCP 服务器配置 |
脚本工具
| 脚本 | 功能 |
|---|---|
.trellis/scripts/task.py | 任务管理（14 个子命令） |
.trellis/scripts/get-context.py | 获取会话上下文 |
.trellis/scripts/get-developer.py | 获取开发者身份 |
.trellis/scripts/init-developer.py | 初始化开发者 |
.trellis/scripts/add-session.py | 记录会话 |
.trellis/scripts/multi-agent/plan.py | Plan 阶段脚本 |
.trellis/scripts/multi-agent/start.py | 启动 worktree Agent |
.trellis/scripts/multi-agent/status.py | 查看状态 |
.trellis/scripts/multi-agent/create-pr.py | 创建 PR |
.trellis/scripts/multi-agent/cleanup.py | 清理 worktree |