> ## Documentation Index
> Fetch the complete documentation index at: https://gnero.genetind.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 附录 A：关键文件路径速查

## 附录 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       |