SuperAPI AI 工具集

project-memory

通用与其它

查看项目

更新于 10-16 00:00

技能介绍

用途:这是项目整理技能,负责页面或原型完成后的后置补充工作,持续维护文档、主题、数据等资源,保持结构清晰、可追溯、可渐进扩展,并通过日志为后续协作留依据。不回头重做页面、原型及其主体实现。

主要能力:执行增量变更检测而非全量维护;按用户明确指定或模糊描述确定扫描范围,未指定时以上次日志时间戳为基准扫描 src/components/、src/prototypes/、src/themes/、src/database/、src/docs/、src/common/,用 find 或 git diff --name-only 获取变更并按类型归类,生成建议清单供确认。首次执行(memory-log.md 不存在或为空)则全量扫描并建议初始化后置资源。

执行顺序:确认后按固定顺序仅处理相关步骤:先做 Git 快照(提交信息格式 chore: snapshot before project-memory <YYYY-MM-DD HH:mm>);再检查或更新 src/docs/project-overview.md 项目说明入口,该文件须保持轻量,达到或超过 1000 行时优先分包拆分与摘要汇总,目标控制在 800 行以内,不用单纯删减;按需维护 page-map.md、information-architecture.md、business-flow.md、data-model.md、permission-model.md、state-lifecycle.md 等专题子文档;仅在检测到相关变更时维护 src/themes/ 主题与 src/database/ 数据,数据须遵循 src/database/README.md,并同步总入口索引;最后追加维护日志。

日志:默认写入 src/docs/memory-log.md,模板来自 src/docs/templates/memory-log-template.md,单行紧凑格式,字段顺序为 YYYY-MM-DD HH:mm | kind | sum | doc | theme | data | git | todo。kind 用 upd(普通维护)或 trim(日志裁剪);sum 尽量 20 字内;未变化字段写 -。日志达到或超过 1000 行时,先删最旧 100 行业务日志,追加一条 trim 日志记录裁剪,再写入本次维护日志;除该规则外只追加不改写历史。

适用场景与限制:适用于原型/组件、文档、主题、数据等变更后的整理与索引同步。仅更新与变更相关的后置资源,不做无关全量刷新;不处理主体实现。与用户沟通优先使用“我可以继续帮你整理并记住 xxx”类自然表达。具体模板内容、初始化骨架细节与完整质量检查清单以源资料为准,此处不展开。