# ZCLAW AI 会话提示词模板

> **用途**: 每次开新的 AI 会话时，根据工作类型选择对应提示词。
> 这些提示词设计为让 AI 立刻理解项目状态和约束，避免重复探索。

---

## 模板 1: 修复缺陷（最常用）

```
我在 ZCLAW 项目中修复缺陷。项目位于当前工作目录。

## 约束
- 先读 docs/STABILIZATION_DIRECTIVE.md 了解当前优先级
- 先读 docs/TRUTH.md 了解系统真实状态
- 新增功能冻结，只做修复
- 每个修复独立提交
- 修复后必须更新 docs/TRUTH.md 中的缺陷状态

## 当前任务
[在此描述要修复的缺陷]

## 修复流程
1. 读相关文件，理解根因
2. 最小修复（不重构不优化）
3. 验证 cargo check + tsc --noEmit
4. 更新 TRUTH.md
5. 提交
```

---

## 模板 2: 接通断链

```
我在 ZCLAW 项目中接通"写了没接"的功能断链。

## 约束
- 先读 docs/STABILIZATION_DIRECTIVE.md 第 2 节
- 先读 docs/TRUTH.md 第 2.3 节，了解哪些功能未接通
- 只做前端集成，不新增后端代码
- 接通后必须有基本的前端测试
- 不引入新的 UI 框架或依赖

## 当前任务
[在此描述要接通的功能]

## 接通流程
1. 读 Rust 端命令签名
2. 读前端 lib/ 层是否已有对应调用函数
3. 如果有函数但未调用 → 在组件/Store 中接入
4. 如果没有函数 → 在 lib/ 层新增，然后在组件/Store 中接入
5. 添加基本测试
6. 更新 TRUTH.md 将功能从 2.3 移到 2.1
```

---

## 模板 3: 清理死代码

```
我在 ZCLAW 项目中清理死代码。

## 约束
- 先读 docs/STABILIZATION_DIRECTIVE.md 第 3 节
- 先读 docs/TRUTH.md 第 4 节，了解已知死代码清单
- 删除前必须确认零引用（grep 全 workspace）
- 不删除 feature-gated 代码（Director/A2A/WASM），只标注
- 不删除有测试的代码

## 清理流程
1. 确认目标文件/目录
2. grep 确认零引用
3. 删除
4. cargo check + tsc --noEmit 验证无破坏
5. 更新 TRUTH.md
```

---

## 模板 4: 文档校准

```
我在 ZCLAW 项目中校准文档。

## 约束
- docs/TRUTH.md 是唯一真相源
- 其他文档中的数字如果与 TRUTH.md 冲突，修改其他文档
- 不新增文档，只修正已有文档
- 审计报告类文档（V5~V9）移到 docs/archive/

## 当前任务
[在此描述要校准的文档]

## 校准流程
1. 对比 TRUTH.md 中的实际值
2. 找出所有不一致
3. 逐一修正
4. 不改变文档结构，只改数值和状态
```

---

## 模板 5: 新功能设计（稳定化完成后使用）

```
我在 ZCLAW 项目中设计新功能。项目位于当前工作目录。

## 前提检查
- 确认 docs/STABILIZATION_DIRECTIVE.md 的完成标准已全部达标
- 如果未达标，先完成稳定化，不要设计新功能

## 约束
- 先读 CLAUDE.md 了解项目定位和决策原则
- 先读 docs/TRUTH.md 了解系统现状
- 新功能必须对应一个真实用户场景
- 必须先规划前端到后端的完整路径，再写代码
- 不允许"先写后端再说"的模式

## 设计流程
1. 描述用户场景（谁、在什么情况下、要完成什么）
2. 设计前端到后端的完整调用链
3. 确认不重复已有功能
4. 确认不影响已有功能
5. 先写测试，再写实现
```

---

## 模板 6: 状态检查（开新会话时快速对齐）

```
请帮我检查 ZCLAW 项目当前状态。

按以下顺序执行：
1. 读 docs/STABILIZATION_DIRECTIVE.md — 了解稳定化进度
2. 读 docs/TRUTH.md — 了解系统真实状态
3. 检查 P0 缺陷是否已修复（SEC2-P0-01, SEC2-P0-02）
4. cargo check --workspace — 验证编译
5. pnpm tsc --noEmit — 验证前端类型

输出：
- 稳定化完成百分比
- 剩余 P0/P1 缺陷清单
- 下一步建议（最多 3 个具体操作）
```

---

## 使用建议

| 场景 | 用哪个模板 |
|------|-----------|
| 修 bug | 模板 1 |
| 接通已有后端能力 | 模板 2 |
| 删无用代码 | 模板 3 |
| 文档修正 | 模板 4 |
| 设计新功能 | 模板 5 |
| 每日开工 | 模板 6 |