用途:为功能、缺陷修复、重构、杂务等建立可追踪的逻辑工作单元(track),用规格说明与分阶段计划组织从创建到完成的整个过程。
主要能力:轨道类型(feature、bug、chore、refactor);ID 格式 {shortname}_{YYYYMMDD};生命周期含创建(newTrack)、实现、完成;spec.md 结构(概述、功能与非功能需求、验收标准、范围、依赖、风险、开放问题);plan.md 结构(阶段、任务、验证、检查点表);状态标记约定([ ] 待办、[~] 进行中、[x] 完成并附提交 SHA、[-] 跳过、[!] 阻塞);tracks.md 注册表分活跃/已完成/已归档;metadata.json 记录状态、阶段、任务计数、检查点、依赖、标签。
使用方式:创建轨道时按交互问答收集需求,先生成 spec.md 与 plan.md 并登记到注册表,再逐任务实现、更新标记并记录提交 SHA;会话结束前更新 progress.md;开始前读取 learnings.md,结束后把新经验、问题、决策写入对应记忆文件。文档给出三条铁律:写实现代码前必须先建轨道目录与 spec.md;没有已提交的 plan.md 不得开始实现;未附提交 SHA 不得标记任务完成。
适用场景:需要语义化范围边界、进度追踪、按轨道回滚、多人协作的软件开发流程。
限制:这是流程方法论文档,官方未提供自动化脚本或工具安装命令,相关执行需依赖宿主环境(如 .claude/context 路径约定)自行准备。