Spec-First

Appearance

记忆系统 ​

概述 ​

Spec-First 通过四层记忆架构维护项目和任务上下文，确保 AI 在每个阶段都能访问到正确的信息。

四层记忆架构 ​

层级路径用途生命周期
项目知识.spec-first/spec/长期项目规范和编码标准持久
任务记忆task.json + PRD当前任务状态和上下文任务期间
会话执行.current-task, .agent-log实时执行状态会话期间
历史沉淀docs/solutions/, journal-N.md历史经验记录持久

各层详情 ​

1. 项目知识记忆（.spec-first/spec/） ​

存储项目的长期规范和编码标准：

  • 架构决策和设计模式
  • 编码规范和命名约定
  • 技术栈选择和约束
  • 项目特有的最佳实践

特点：

  • 通过 spec-first init --claude 初始化
  • 在 Compound 阶段持续更新
  • 所有工作流阶段的共享上下文

2. 任务记忆（task.json + PRD） ​

跟踪当前任务的完整上下文：

  • 任务元数据（ID、状态、优先级）
  • 关联的需求文档和计划
  • 当前执行进度
  • 任务依赖关系

两种 PRD 类型：

类型用途何时生成
Bootstrap PRD新项目初始化首次接入 spec-first
Feature PRD功能需求迭代Brainstorm 阶段

3. 会话执行记忆（.current-task, .agent-log） ​

记录当前会话的实时执行状态：

  • 正在执行的操作
  • Agent 活动日志
  • 中间状态和检查点

特点：

  • 会话结束即清除
  • 用于保持工作连续性
  • 支持异常恢复

4. 历史沉淀记忆（docs/solutions/） ​

通过 Compound 阶段积累的可复用知识：

  • 问题根因分析和解决方案
  • 最佳实践和经验教训
  • 可复用的代码模式
  • 项目规范更新

目录结构：

docs/solutions/
├── build-errors/
├── test-failures/
├── runtime-errors/
├── performance-issues/
├── database-issues/
├── security-issues/
├── ui-bugs/
├── integration-issues/
├── logic-errors/
├── developer-experience/
├── workflow-issues/
├── best-practices/
└── documentation-gaps/

与五阶段工作流的集成 ​

Brainstorm ─→ 读取项目知识 + 历史沉淀
Plan ────────→ 读取任务记忆 + 项目知识
Work ────────→ 读取任务记忆 + 项目知识
Review ──────→ 读取历史沉淀（learnings-researcher 搜索 docs/solutions/）
Compound ────→ 写入历史沉淀（docs/solutions/）

关键循环： Compound 阶段将经验写入记忆系统，Brainstorm 和 Review 阶段自动发现和引用历史知识，形成知识复利。

记忆维护 ​

Compound Refresh ​

使用 /spec:compound-refresh 定期维护历史沉淀：

维护动作说明
Keep仍然准确，保持不变
Update核心方案正确但细节过时
Consolidate多个文档重叠，合并
Replace已有更好的替代方案
Delete不再适用

自动发现 ​

Review 阶段的 learnings-researcher agent 自动搜索 docs/solutions/，将相关的历史经验注入当前审查上下文。

下一步 ​