Files
zclaw_openfang/docs/AI_SESSION_PROMPTS.md
iven d8e2954d73 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
2026-04-03 00:29:16 +08:00

4.0 KiB
Raw Blame History

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