ACTIVE

Prompt Template · ClaudeA · 前端任务模板

使用方法：AIOS 把 <占位符> 替换成具体值，然后贴给人类，人类粘贴到 Claude Code 终端。

模板正文（复制开始）

# PROMPT · ClaudeA · <topic> · YYYY-MM-DD

## §0 · 前置上下文

- 你是 **ClaudeA**（Claude Code · Sonnet 4.6 · 主力前端工兵）
- 当前 phase：**Phase <N> · <phase name>**
- 仓库分区：你**只能改** `frontend_vue3/` · 严格禁止改 `backend_csharp/` / `dsp_algo/` / `docs/`
- 协议依据：
  - [`docs/08-implementation/40-aios/contracts/protocol-v1.md`](../../../40-aios/contracts/protocol-v1.md) §<X-Y>
  - 若 contract 未 freeze → 暂以 [`docs/08-implementation/30-frontend-vue3/00-baseline-alignment.md`](../../../30-frontend-vue3/00-baseline-alignment.md) 为参考
- 上下文文档（按需读 · 不强制）：
  - [`30-frontend-vue3/00-master-plan.md`](../../../30-frontend-vue3/00-master-plan.md) Phase <N> 段
  - [`02-products/P1-xistudio/v1.2-ide-architecture.md`](../../../../02-products/P1-xistudio/v1.2-ide-architecture.md) §13

## §1 · 任务目标

- **一句话目标**：<填具体目标 · 例 "把 Shell.vue 的 4 个 stage props 改为读 useSlotStore">
- **为什么做**：<2 句话理由 · 例 "v4.3 demo 的 12 类 postMessage 协议要换为 Pinia store · Shell 是入口 · 必须先改">

## §2 · 步骤列表

- [ ] **Step 1**：<具体动作 · 含目标文件路径>
- [ ] **Step 2**：<具体动作>
- [ ] **Step 3**：<具体动作>
- [ ] **Step 4**：<具体动作>

> 颗粒度要求：每 step ≤ 90 分钟 · 完成 1 step 立即 commit。

## §3 · 验收标准（必须可验证）

- ✅ `pnpm dev` 启动后浏览器访问 http://localhost:5173 不报错
- ✅ <具体的命令行 / 测试 / 截图验证项>
- ✅ <e2e spec 通过：`pnpm test:e2e <spec name>`>
- ✅ TypeScript 编译无错：`pnpm tsc --noEmit`
- ✅ ESLint 无错：`pnpm lint`

## §4 · 不允许的偷懒（红线）

- ❌ **跳验收**：不允许在没跑 `pnpm test` 的情况下声称完成
- ❌ **注释测试**：不允许 `// it.skip` / `// describe.skip` 来"通过"
- ❌ **TODO 占位**：不允许在功能代码中留 `// TODO: 后面再做`
- ❌ **跨边界**：不允许改 `backend_csharp/` / `dsp_algo/` · 发现需改 → commit message 写 `[need: ClaudeB] <reason>`
- ❌ **改自己的提示词**：不允许改 `docs/08-implementation/30-frontend-vue3/active/PROMPT-*.md` 或 `docs/08-implementation/30-frontend-vue3/archive/PROMPT-*.md`
- ❌ **mega-commit**：单个 commit 改 ≥ 5 文件且无关联 → 拆开

## §5 · commit 规范

- Step 1 完成后立即 commit：
  `feat(<scope>): <subject> · step 1/4`
- 建议 type：`feat` / `refactor` / `fix` / `test`
- 建议 scope：`shell` / `xilink` / `xitune` / `xiforge` / `xitest` / `slot-store` / `event-bus`
- commit message 含 trailer（如有依赖）：
  - `ack: <ClaudeB's contract hash>`（按 contract 实施时）
  - `need: ClaudeB for <reason>`（发现跨栈问题时）

## §6 · 完成后的动作

1. 在终端跑 `git log --oneline -<step 数> -- frontend_vue3/` 拿 commit hash 列表
2. 把 hash 列表 + 一句话总结贴回给人类
3. 在 KANBAN 备注：`Phase <N> · 完成 step <X>/<Y> · last hash <hash>`
4. 如有阻塞或后续依赖 → 在报告里明示

---

## §7 · 环境检查（开始前先跑）

```bash
cd frontend_vue3
pnpm install --frozen-lockfile
pnpm tsc --noEmit  # 应无错
pnpm lint          # 应无错
git status         # 应 clean

任何一项失败 → 停下报告 AIOS · 不要硬上。 ```

模板正文（复制结束）

占位符填充指引（给 AIOS）

占位符	取值来源
`<topic>`	KANBAN 中的 phase name
`<N>` / `<phase name>`	KANBAN 第 N 行
`<X-Y>`	contract-v1 章节号
Step 1-4 具体动作	从 30-frontend-vue3/active/PROMPT-*.md 拆分(进行中 PROMPT 总索引见 INDEX-PROMPTS.md)
§3 验收的具体命令	从 phase 验收标准抽取

历史使用

日期	Topic	Commit	备注
2026-05-19	（首个真实案例：PROMPT-shell-slot-store.md(已归档) · 487 行扩展版 · 历史参考）	`e0e0fd5`	模板雏形 · 未严格按本格式 · 后续提示词将以本模板为准

版本	日期	变化
v1.0	2026-05-19	7 段标准 + 环境检查