SuperAPI AI 工具集

project-chronicles

编程与开发

查看项目

更新于 10-16 09:47

技能介绍

用途:在项目中建立并维护两轨文档——工作日志(与代码绑定的实现决策)和使用笔记(持久的产品/流程观察),帮助未来的自己或 AI 会话快速定位上下文。判断标准:笔记会因代码变化而失效,归入工作日志;否则归入使用笔记。

使用方式分四个阶段。一、检测:先扫描项目根目录中已有的配置(CLAUDE.md、AGENTS.md、.cursor/rules 等)、docs/notes/journal 等文档目录、CHANGELOG 或 ADR 等实现记录系统,并说明将如何整合而非替换。二、确认配置:与用户确认文档根目录(默认 docs/)、工作日志是单文件还是按季度子文件夹、使用笔记子目录(默认 docs/usage/)、会话启动配置写在哪、命名约定。若检测到 OpenSpec、ADR 等实现记录系统,可进入委托模式,跳过工作日志,只搭建使用笔记并让会话启动指向该记录系统。三、搭建:只创建不存在的目录与初始文件,不覆盖已有内容;使用笔记目录附简短 README。四、持续使用:完成重要工作块后按模板追加工作日志条目,包含日期、摘要、Agent(工具+模型或 human)、Scope(一两个词);使用笔记按主题而非日期命名,自由格式,记录观察、重要性与未决问题。会话启动只需扫描文件名并读最近一两篇,用于快速定位而非全面回顾。

限制:不可创建后不维护;工作日志不应只是 git 提交摘要;使用笔记不写实现细节;两轨不可合并;季度命名等约定应匹配项目节奏。官方文本未提供具体的安装或调用命令,亦未说明收费与平台支持情况,暂未提供。