跳转到主要内容

​
你的第一个任务

​
3.1 启动会话

打开 Claude Code 终端，session-start.py Hook 自动触发，上下文已注入。你可以直接描述任务，也可以运行 /start 了解完整流程。AI 会自动执行以下操作：
  1. 读取 workflow.md 了解开发流程
  2. 运行 get-context.py 获取当前状态（你的身份、Git 状态、活跃任务）
  3. 读取 spec/frontend/index.md 和 spec/backend/index.md 了解项目规范
  4. 问你：“What would you like to work on?”

​
3.2 AI 创建任务并开发

你说：“添加用户登录功能”。AI 会： 
1. 调用 Research Agent 分析代码库
   → 找到相关 spec 文件和代码模式

2. 创建任务目录
   → .trellis/tasks/02-27-user-login/
   → 生成 task.json、prd.md、implement.jsonl 等

3. 激活任务
   → task.py start（设置 .current-task）

4. 调用 Implement Agent
   → Hook 自动注入 implement.jsonl 中配置的所有 spec
   → Agent 按规范实现功能

5. 调用 Check Agent
   → Hook 注入 check.jsonl 中配置的检查规范
   → Agent 检查代码质量并自动修复
   → Ralph Loop 确保 lint/typecheck 通过

​
3.3 测试和提交

AI 完成后会提示你： 
# 运行项目测试
pnpm lint && pnpm typecheck && pnpm test

# 确认功能正常后提交
git add src/components/LoginForm.tsx src/api/auth.ts
git commit -m "feat(auth): add user login feature"

​
3.4 记录会话

/record-session
AI 会调用 add-session.py，将本次会话内容追加到你的 journal 文件中，并更新个人索引。

​
3.5 第二天回来 — 跨会话记忆

第二天打开新会话，输入 /start： 
AI: "Hi Alice! 昨天你完成了用户登录功能 (commit abc1234)，
     包括: LoginForm 组件、JWT middleware、users 表。
     今天想做什么？"
AI 通过 session-start.py Hook 读取了你的 workspace journal，记住了上次的工作内容。
平台差异: Claude Code 和 OpenCode 通过 Hook 自动读取 journal 实现跨会话记忆。 Cursor、Codex 用户需要通过 /start（或 $start）命令手动触发上下文加载，才能获得跨会话记忆。