baa-conductor

commit

4bef17e

parent

2f6ec85

author

im_wower

date

2026-03-28 18:01:51 +0800 CST

docs: add push step to task template, add T-S044 pnpm env fix

- Task template now explicitly requires pushing branch to remote
- Separate "完成后提交与推送" from "合并步骤（由合并者执行）"
- T-S044: install pnpm to PATH (blocker found during T-S039)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  1@@ -0,0 +1,109 @@
  2+# Task T-S044：修复 pnpm 环境（安装 pnpm 到 PATH）
  3+
  4+## 状态
  5+
  6+- 当前状态：`待开始`
  7+- 规模预估：`S`
  8+- 依赖任务：无
  9+- 建议执行者：`均可`（一行命令）
 10+
 11+## 直接给对话的提示词
 12+
 13+读 `/Users/george/code/baa-conductor/tasks/T-S044.md` 任务文档，完成开发任务。
 14+
 15+## 当前基线
 16+
 17+- 仓库：`/Users/george/code/baa-conductor`
 18+- 分支基线：`main`
 19+- 提交：`2f6ec85`
 20+
 21+## 分支与 worktree（强制）
 22+
 23+- 分支名：`fix/pnpm-env`
 24+- worktree 路径：`/Users/george/code/baa-conductor-pnpm-env`
 25+
 26+开工步骤：
 27+
 28+1. `cd /Users/george/code/baa-conductor`
 29+2. `git worktree add ../baa-conductor-pnpm-env -b fix/pnpm-env main`
 30+3. `cd ../baa-conductor-pnpm-env`
 31+
 32+完成后提交与推送：
 33+
 34+1. 在 worktree 里提交所有变更（包括更新后的任务文档）
 35+2. `git push -u origin fix/pnpm-env`
 36+
 37+合并步骤（由合并者执行）：
 38+
 39+1. `cd /Users/george/code/baa-conductor`
 40+2. `git fetch origin`
 41+3. `git merge origin/fix/pnpm-env`
 42+4. `git push`
 43+5. `git worktree remove ../baa-conductor-pnpm-env`
 44+
 45+## 目标
 46+
 47+确保 pnpm 在系统 PATH 中可用，所有任务的验证命令（`pnpm build`、`pnpm test`）能直接运行。
 48+
 49+## 背景
 50+
 51+T-S039 执行过程中发现 `pnpm` 和 `corepack` 都不在 PATH 里。当前系统只有 `npm@11.11.0` 和 `node@25.8.1`。
 52+
 53+## 必须完成
 54+
 55+### 1. 安装 pnpm
 56+
 57+二选一：
 58+
 59+方案 A（推荐）：
 60+```bash
 61+npm install -g pnpm
 62+```
 63+
 64+方案 B（通过 corepack）：
 65+```bash
 66+corepack enable
 67+corepack prepare pnpm@latest --activate
 68+```
 69+
 70+### 2. 验证
 71+
 72+- `which pnpm` 输出路径
 73+- `pnpm --version` 输出版本号
 74+- `cd /Users/george/code/baa-conductor && pnpm install` 成功
 75+- `pnpm build` 成功
 76+- `pnpm test` 成功
 77+
 78+### 3. 更新文档（如需）
 79+
 80+如果选方案 B 或者有额外配置，在 `docs/runtime/environment.md` 补充说明。
 81+
 82+## 验收标准
 83+
 84+- `pnpm --version` 在任意新 shell 中可用
 85+- `cd /Users/george/code/baa-conductor && pnpm build` 通过
 86+
 87+## 执行记录
 88+
 89+> 以下内容由执行任务的 AI 填写，创建任务时留空。
 90+
 91+### 开始执行
 92+
 93+- 执行者：
 94+- 开始时间：
 95+- 状态变更：`待开始` → `进行中`
 96+
 97+### 完成摘要
 98+
 99+- 完成时间：
100+- 状态变更：`进行中` → `已完成`
101+- 修改了哪些文件：
102+- 核心实现思路：
103+- 跑了哪些测试：
104+
105+### 执行过程中遇到的问题
106+
107+> 记录执行过程中遇到的阻塞、环境问题、临时绕过方案等。合并时由合并者判断是否需要修复或建新任务。
108+
109+### 剩余风险
110+

 1@@ -82,12 +82,18 @@
 2 3. `cd ../baa-conductor-<short-branch-name>`
 3 4. 在这个 worktree 目录里开发，不要回到主仓库目录
 4 
 5-完成后合并步骤：
 6+完成后提交与推送：
 7 
 8-1. 在 worktree 里提交所有变更
 9-2. `cd /Users/george/code/baa-conductor`
10-3. `git merge <分支名>`
11-4. `git worktree remove ../baa-conductor-<short-branch-name>`
12+1. 在 worktree 里提交所有变更（包括更新后的任务文档）
13+2. `git push -u origin <分支名>`
14+
15+合并步骤（由合并者执行）：
16+
17+1. `cd /Users/george/code/baa-conductor`
18+2. `git fetch origin`
19+3. `git merge origin/<分支名>`
20+4. `git push`
21+5. `git worktree remove ../baa-conductor-<short-branch-name>`（如果 worktree 还在）
22 
23 合并冲突处理：
24 
25@@ -233,6 +239,7 @@ AI 收到任务文档后，必须按以下顺序操作：
26    - 跑了哪些测试
27 3. 在"执行记录 > 剩余风险"区域填写风险点，如果没有写"无已知风险"
28 4. 提交所有变更（包括更新后的任务文档本身）
29+5. 推送分支到 remote：`git push -u origin <分支名>`
30 
31 ### 遇到阻塞或环境问题时
32