用途:在软件项目中建立或改进可追溯开发流程,从需求到实现保持完整追溯链条,适合新项目起步、既有项目补齐追溯、并行协作以及生产问题回溯需求与设计。主要能力:采用 5 位 Base36 随机 ID(如 a3bf2)避免并行开发冲突;用文档内 Links 段实现分布式追溯,无需中心跟踪文件;提供分析(AN-)、需求(FR/NFR-)、ADR、任务(T-,含 design.md 与 plan.md)等模板;附带初始化、建文档、生成 ID、追溯分析脚本;可在提交信息、代码注释和日志中引用需求 ID。使用方式:先运行 python scripts/init_tdl_docs.py 初始化目录,再按分析→需求→ADR→设计计划阶段用对应 create_*.py 脚本创建文档,用 python scripts/tdl_new_id.py 生成 ID,用 python scripts/trace_status.py 查看追溯状态或配合 CI 检查;在 Claude Code 中意图不明时会用 AskUserQuestion 确认文档类型等。限制:所有文档目前仅支持英文,日期格式为 YYYY-MM-DD;ID 在约 1100 份文档时碰撞概率约 1%;需自行安装 Python 环境;其他平台的具体支持情况暂未提供。
tdl
编程与开发
更新于 10-16 08:10