快速开始

1. 安装

codex plugin marketplace add KKenny0/Tracework
codex plugin add tracework@tracework

更新：

codex plugin marketplace upgrade tracework
codex plugin add tracework@tracework

2. 配置 Vault

首次运行：

/tracework:cold-start-interview

这会把配置写入 ~/.tracework/config.yaml 或 {project}/.tracework/config.yaml。

3. 先生成可用输出

从你当前需要的输出开始：

/tracework:daily
/tracework:weekly
/tracework:query why did we choose <the decision>?

没有 raw entries 时，日报和周报会用 git 作为 limited fallback coverage。它们不应 补写动机、取舍或已验证影响。

4. Capture 关键 Session

重要工作结束时说：

收工

或运行：

/tracework:capture

长任务中途可以记录阶段进展：

/tracework:capture checkpoint

Capture 会根据 session 信号自动路由为 lite、standard 或 deep。它应该记录 git 无法解释的决策、放弃路径、风险、证据、artifact 变化和下一步。没有 vault 时， 它也可以直接在对话里返回结构化 recap。

5. Query 一个 Decision

问一个具体的 why 问题：

/tracework:query why did we choose <the decision>?

好的回答应该包含匹配到的 decision nodes、raw source_entry_refs、被记录的 rejected alternatives，以及记录不足时明确的 evidence gap。

6. 复用记录

Command	何时使用	目的
/tracework:recall	有几次 capture 之后	开工时恢复 durable context
/tracework:weekly	现在，或有一周记录之后	生成 brief-ready outline
/tracework:monthly	现在，或有一个月日报之后	生成 review 和候选规则
/tracework:roadmap	积累多个 decision 后	复盘决策如何演变

Storage

Tracework 读取配置的顺序：

1. {project}/.tracework/config.yaml
2. ~/.tracework/config.yaml

请在其中一个文件里配置 knowledge_vault。Tracework 会把 raw entries、decision indexes 和可读输出写入这个 vault。