SuperAPI AI 工具集

tl-devlog

通用与其它

查看项目

更新于 10-16 03:37

技能介绍

用途:在项目仓库中维护一份持续更新的开发日志 DEVLOG.md,记录决策、进展、事故与洞见,使后续会话能了解做过什么及原因。

主要能力:支持用户显式触发(如“log this”“devlog”“记录这个决策”)及在自然停顿点主动建议记录。提供八类分类:architecture、milestone、incident、bug、ops、design、strategy、takeaway。条目采用固定格式,含日期、标题、分类、标签、摘要、详情与相关链接,默认倒序(最新在前)。支持读取与检索历史条目,按分类、标签、日期或关键词搜索。可将架构条目提升为 MADR 4.0 格式的 ADR,并双向链接;可将 milestone 条目映射为 Keep a Changelog 格式的 CHANGELOG。支持一次会话多条记录并单次提交。

使用方式:会话中先确定项目(git 仓库根目录),判定分类与内容,起草条目并展示给用户确认,然后更新 DEVLOG.md,经用户同意后执行 git add DEVLOG.md、git commit -m "devlog: [brief title from entry]"、git push origin HEAD。存储默认项目模式({repo_root}/DEVLOG.md),可选本地(.devlog/)或全局(~/.devlog/)。

限制与安全:禁止在日志中保存密钥、API 密钥、令牌或凭据,敏感信息须脱敏;提交前必须展示草稿;未经用户确认不得自动推送。非 git 仓库、推送失败、合并冲突、无写权限等情况有相应处理方式。日常问答、无决策点的进行中工作、不改变方向的微小澄清不记录。具体平台、收费、价格、效果等信息暂未提供。