DevSpecs 是一款本地优先（local-first）的命令行工具，面向 AI 辅助的既有代码库（brownfield）开发场景。它的核心目标是为 AI 编码智能体在仓库中产生的工作保留一条持久的“意图线索”（intent trail），让开发者或智能体在离开一段时间后回来，仍能理解变更为何存在、当前处于什么状态、以及接下来该做什么。
用途
DevSpecs 解决的是 AI 编码智能体工作中“线索丢失”的问题。Git 能显示代码改了什么，但无法说明为何改、下一步该关注什么。DevSpecs 在 Git 和 rg 之上补充本地线索层：变更为何存在、处于什么生命周期状态、被取代的工作，以及下一个继续的入口。它面向需要与现有编码智能体协作、并希望保留可恢复上下文的开发者。
主要能力
- 本地意图线索：将 AI 编码工作的持久线索附加到仓库，记录智能体改了什么、为何存在、下一步该审查什么。
- 上下文恢复：帮助在审查或继续工作前，恢复活跃线索、生命周期状态和可能的下一步上下文。
- 证据关联：读取仓库文件、文档、规格、计划、提交记录和任务记录，把证据、决策、检查点和有界交接保持连接。
- 任务切片与检查点：可创建轻量任务规格，包含打包上下文、门禁（gates）、迭代切片（iteration slices）和检查点（checkpoints）。
- 与现有编码智能体协作：不替代现有智能体，输出其可用的上下文。
- 本地索引：写入本地任务文件和本地 SQLite 索引。
使用方式
DevSpecs 以命令行工具形式提供，安装后使用 ds 命令。官方资料提到可在五分钟内在仓库中尝试：
- 当回来时对上下文感到陌生，可先运行 ds recent。
- 当目标已经明确时，可使用 ds task。
- 在大型仓库首次运行时，DevSpecs 会显示索引进度，同时保持安静并让 JSON 输出干净。
- 建议在一个真实的仓库的可丢弃检出（disposable checkout）中试用，例如使用 FastAPI 感受线索恢复与任务交接循环，而不先触碰自己的代码；完成后可删除该检出。
适用场景
适合与现有编码智能体配合的开发者，在智能体运行后需要回顾、审查或继续工作时使用；适合希望保留本地 AI 工作层、又不替代 Jira、Linear、GitHub Issues 或 Notion 等事务追踪器的团队。也可作为仓库中已分散意图的本地导航层。
限制与说明
- 不调用 LLM：CLI 本地优先且刻意保持简单，仅索引本地产物并输出上下文供现有智能体使用。
- 不做云同步：所有处理在本地进行。
- 不替代事务追踪器：仍需保留 Jira、Linear、GitHub Issues 或 Notion，DevSpecs 只跟踪其下的本地 AI 工作层。
- 与 OpenSpec 等规格框架的关系：部分相似但范围更广，既可创建带打包上下文、门禁、迭代切片和检查点的轻量任务规格，也可作为本地导航层。
- 官方资料未提及收费、价格、具体平台支持列表等信息，暂未提供。
