docs: stabilization directive + TRUTH document + AI session prompts + dockerignore
- 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
This commit is contained in:
iven
159
docs/AI_SESSION_PROMPTS.md
Normal file
159
docs/AI_SESSION_PROMPTS.md
Normal file
@@ -0,0 +1,159 @@
|
||||
# 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 |
|
||||
Reference in New Issue
Block a user