JohnXu22786/file-planning

README 摘要

trailmap（轨迹地图） 磁盘持久化的执行规划插件：把多步骤任务的 计划、执行状态、考察笔记与复盘纪要 全部落在工作区 .trail/ 目录里。会话中断、上下文压缩、换会话重启都不丢方向—— 恢复后读一眼状态即可继续。 - 状态机驱动 ：步骤 待办 → 进行中 → 完成 （可取消/复活），依赖未满足的 步骤自动标记为「受阻」；里程碑与计划状态由步骤派生，无需手工维护。 - 计划模板生成器 ：按任务类型（调研/开发/文档/空白）一键生成里程碑骨架， 自动接好步骤依赖，创建后仍可随时增删改。 - 依赖标注 ：步骤可声明依赖， start 受依赖门控；循环依赖会被检测并阻断。 - 审计事件流 ：每次推进都写入追加式事件记录，复盘自动引用，过程可追溯。 - 复盘纪要 ：收尾时自动汇总里程碑/步骤/取消项/时间线，手写回顾区跨次生成 保留。 - 确定性收尾闸门 ： check 判定全部步骤闭合且结构无问题，避免"以为做完了"。 - 三种接口 ：dsh 工具（10 个 trailmap ）、独立 CLI（ trail ）、技能 （SKILL.md），共享同一核心。 快速开始（CLI，零依赖） （或 npm link 后直接使用 trail 命令； TRAILMAP DIR 环境变量指定工作区， 缺省为当前目录。） 接入 dsh（插件化 harness） harness 通过 cordis.patch.yml 插入插件行，Cordis 注入 ctx.tools 并注册全部 工具；模型即可调用 trailmap 完成建计划/推进/复盘全流程。技能放在 skill/trailmap/ 。详见 docs/integration.md。 工作区文件 .trail/ 默认不纳入版本控制。文件格式与状态机详见 docs/format.md。 命令速查 命令 作用 trail init [--kind …] [--name 别名] 建轨迹（模板骨架 + 依赖接线） trail status [--history] [--json] 状态总览 trail start/finish/drop/reopen 步骤状态机（drop 需 --reason ） trail amend … 中途修正计划结构 trail note [--section 小节] 考察笔记 trail journal 行程日志 trail check [--json] 完成判定闸门（未通过时退出码 1； --json 模式退出码恒 0，以 ok 字段为准） trail debrief [--close] / trail close 复盘（+归档） trail render 手工编辑 map.json 后重生成视图 trail plans / switch / switch root 多计划管理 开发 - lib/ma…

分类