每次开新 session 都让 AI agent 重新理解项目？这个工具想让 coding agent 不再”失忆”

你有没有这种感觉——AI coding agent 用了半天，session 一关，它就把这个项目的 context 全忘光了？下次开新 session，又要重新解释一遍功能点、PRDs、之前的决策理由……

这就是 Feature Track 要解决的问题。

它是什么

Feature Track 是一个「轻量级 repo 原生记忆层」，专门给 AI coding agent 用。它在项目里建一个 docs/features/ 目录，每个 feature 一小片 Markdown 文件，存放：当前状态、权威文档指向、已做决策、风险点、最近变更。

AI agent 下次来，直接读这片文件就知道「这个功能现在什么状态、哪些文档还有效、之前为什么这么设计」。不用再从 PRDs/聊天记录/commit 历史里东拼西凑。

怎么工作

目录结构很清晰：

docs/features/
├── README.md              # 全局 feature 索引
└── <feature-id>/
    ├── README.md          # 当前 feature 记忆
    ├── prd/               # PRD 文档
    ├── api/               # API 说明
    ├── plans/             # 过往计划
    └── archive/           # 归档

每个 feature 的 README 回答四个核心问题：
– 现在什么是真的？
– 哪些文档是当前权威来源？
– 后续 agent 需要保留哪些决策？
– 有哪些风险、迁移约束或最近变更要注意？

解决了什么问题

• 不再重复探索：agent 切换 session 后不用重新「发现」功能现状
• 抵抗 context 漂移：老旧 plan 有时候看起来很权威，但现实已经变了——Feature Track 强调「当前真相」
• 跨 agent 共享：Codex、Claude Code、多 agent 协作时，大家读同一份 track
• 轻量：不用搭数据库，不用引入重的流程，小团队/独立开发者直接用

适用场景

• 多人协作的 AI 辅助开发团队
• 长期项目（feature 生命周期很长，容易丢失 context）
• 跨 session 工作（session 关了再开，记忆清零）
• brownfield 项目（文档散落各处，agent 难以判断哪份是权威）

快速上手

# 1. 在项目根目录初始化
docs/features/
├── README.md              # 全局索引
└── <feature-id>/
    └── README.md          # 单个 feature

# 2. 问 agent
"帮我创建 XX feature 的 track 文件"

# 3. agent 会按规范生成 README，然后每次都从这里读取上下文

GitHub 链接

⭐ 121 stars | MIT License

👉 https://github.com/JunsW/feature-track

如果你经常和 AI coding agent 打交道，或者团队里多人共用 AI 辅助开发环境，Feature Track 是一个投入极低但回报很高的工具。不需要改流程，直接放进 repo 就能用。

GitHub: https://github.com/JunsW/feature-track