Agent Skills
返回列表
项目记忆管理

项目记忆管理

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_1ae97d99/project-memory。

技能介绍

要解决的问题

大模型跨会话开发项目时,常见两个工程问题:上下文被历史细节淹没,以及 AI 重复创建已经存在的组件、工具函数、API 或数据库表。如果把全部记忆塞进一个 project-memory.md,主文件会快速膨胀;如果完全不记录,新会话又会丢失已有约定。

技能如何工作

这个技能用模块化文件结构替代单一大记忆文件:

  • project-memory.md 只保留阶段状态、关键决策和入口信息,控制在 30 行以内。
  • dev-docs/index.md 维护组件、hooks、utils、API、数据库表的精简索引。
  • dev-docs/components、dev-docs/api、dev-docs/database 等子目录存放完整定义,按需读取。
  • init_memory.py 初始化目录结构,read_memory.py 默认读取主文件和索引,update_memory.py 更新记忆并重建索引,archive_phase.py 归档阶段并汇总已有资产。

创建新组件时,技能会先检查索引中是否已有同类定义,再写入文档,然后实现代码;修改现有组件时,也要求先更新文档,降低代码与记忆脱节的风险。

适用边界

它更适合有前端组件、接口和表结构的项目,尤其是跨会话迭代场景。对于一次性脚本或无稳定资产的小任务,引入目录结构会增加维护成本;文档仍需人工或 Agent 持续同步,否则索引会滞后于真实代码。

使用场景

  • 跨会话继续电商项目时,读取 project-memory.md 与 dev-docs/index.md,恢复已有组件、API 和表结构。
  • 创建登录表单组件前,检查 dev-docs/components 是否已有同类组件,先写组件文档再实现代码。
  • 归档阶段 2 时,用 archive_phase.py 汇总阶段总结、任务完成情况和 dev-docs 资产清单。
  • 修改 API 或数据库表后,更新对应 dev-docs 文件并重建索引,保持新会话上下文一致。

适合人员

  • 维护前端组件库的工程师,希望新会话不再重复创建已有按钮、表单和 hooks。
  • 做多阶段开发的 Agent 工程师,想把项目状态、组件定义和技术决策沉淀到轻量记忆文件。
  • 负责前后端联调的工程师,需要把 API、表结构和工具函数索引化,避免上下文遗漏。
  • 带项目归档需求的工程负责人,要定期汇总阶段产出、已有资产和决策记录。