memory-manager

内存管理器

维护整洁、有序的项目记忆。

激活条件

在以下情况下激活：

• 完成任何阶段的工作（研究、设计、实现）后
• 任务完成后
• 项目状态似乎不一致时
• 请求定期维护时
• 用户说“清理项目文件”或“更新项目状态”时

工作流

1. 加载当前状态

使用 Read 读取 {project_path}/project_state.md

提取：

• 当前阶段
• 上次更新日期
• 当前重点
• 进度摘要

2. 扫描项目文件

v3.0.0 文件夹结构支持：

使用 Bash 和 ls -d 列出任务目录：

# List task directories (not .md files)
ls -d {project_path}/implementation_process/in_progress/*/ 2>/dev/null
ls -d {project_path}/implementation_process/completed/*/ 2>/dev/null

对于找到的每个任务目录，检查是否包含：

• task.md（主跟踪文件）——必需
• research.md（第 1 阶段内容）——可选
• architecture.md（第 2 阶段内容）——可选
• implementation.md（第 3 阶段内容）——可选

还要扫描架构文件夹：

{project_path}/architecture/*.md

统计：

• 组件架构（architecture/*.md）
• 进行中的任务（in_progress/ 中的目录）
• 已完成的任务（completed/ 中的目录）

向后兼容：

如果找到 *.md 文件（而不是目录），请发出警告：

⚠️  Old v2.x format detected: {count} single-file tasks

Run `/drupal-dev-framework:migrate-tasks` to upgrade to v3.0.0 folder structure.

3. 检测不一致之处

检查以下问题：

问题	检测方式	修复方法
空文件	文件大小 = 0	询问是否删除或填充内容
孤立任务	任务位于错误的文件夹	移至正确位置
状态过期	project_state.md 已过时	更新当前重点
文件缺失	引用了文件但未找到	创建文件或更新引用

4. 更新 project_state.md

使用 Edit 更新：

# {Project Name}

**Updated:** {today's date}
**Phase:** {detected phase}
**Status:** {current status}
**Path:** {project_path}

## Overview
{Keep existing or update based on recent work}

## Progress
- Phase 1 (Research): {Complete/In Progress} - {count} research files
- Phase 2 (Architecture): {Complete/In Progress} - {count} component files
- Phase 3 (Implementation): {X}/{Y} tasks complete

## Current Focus
{What's actively being worked on}

## Key Decisions
| Date | Decision | Rationale |
|------|----------|-----------|
{add new decisions, keep old ones}

## Next Steps
1. {Immediate next action}
2. {Following action}

5. 整理文件

如果文件位置不正确，使用 Bash 移动文件：

v3.0.0 文件夹结构：

# Move completed task directory from in_progress
mv "{project_path}/implementation_process/in_progress/{task_name}/" \
   "{project_path}/implementation_process/completed/{task_name}/"

v2.x 单文件（向后兼容）：

# Move completed task file from in_progress
mv "{project_path}/implementation_process/in_progress/{task_name}.md" \
   "{project_path}/implementation_process/completed/{task_name}.md"

6. 清理

删除任何内容前先询问：

Found {count} empty/orphaned files:
- {file 1}
- {file 2}

Delete these? (yes/no/review each)

7. 更新项目注册表

更新 ~/.claude/drupal-dev-framework/active_projects.json 中的注册表：

1. 读取注册表文件
2. 按路径查找此项目
3. 更新：
   • lastAccessed：今天的日期
   • status：如果所有任务均已完成，则设为 "active" 或 "archived"
4. 写入更新后的注册表

如果项目不在注册表中，询问是否添加：

This project is not in the registry.
Add it for easier access next time? (yes/no)

8. 报告

显示摘要：

Memory cleanup complete:

Files scanned: {count}
Issues found: {count}
Issues fixed: {count}

Current state:
- Phase: {phase}
- Architecture files: {count}
- Tasks in progress: {count}
- Tasks completed: {count}

project_state.md updated.
Registry updated.

精简记忆原则

遵循以下规则：

• 单一事实来源——不要重复信息
• 总结，不复制——引用外部文件
• 归档，不删除——移至 completed/，不要移入回收站
• 就地更新——不要创建带版本号的副本（使用 main.md，而非 main_v2.md）

停止点

在以下情况下停止并等待用户：

• 删除任何文件之前
• 进行重大重组之前
• 显示清理摘要之后