d8e2954d73
- STABILIZATION_DIRECTIVE.md: feature freeze rules, banned actions, priorities - TRUTH.md: single source of truth for system state (crate counts, store counts) - AI_SESSION_PROMPTS.md: three-layer prompt system for AI sessions - Industry agent delivery design spec - Stabilization test suite for regression prevention - Delete stale ISSUE-TRACKER.md - Add .dockerignore for container builds - Add brainstorm session artifacts
160 lines
4.0 KiB
Markdown
160 lines
4.0 KiB
Markdown
# 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 |
|