Local Work Tracker 是一个仓库本地的 Feature 负责人索引工具，定位为在没有 Jira、Linear、GitHub Issues 或其他运营追踪器时，为团队提供一种有意为之、由 Git 支撑的回退方案。它不是一个任务追踪器，而是一个负责人索引，主要目的是防止本地智能体窗口选择另一个人的 Feature。
用途 该工具用于在仓库内显式初始化或操作 Feature 负责人索引。它适用于需要本地参与者身份、Feature 所有权记录，但尚未配置外部追踪器的场景。它不会隐式调用，使用前应先检查仓库说明和现有追踪器配置；如果外部追踪器已经管理实时状态，除非用户明确要求迁移，否则应停止使用。
主要能力 初始化本地身份和存储：从仓库根目录运行 scripts/waypoint_tracker.py，使用 init 命令并指定 actor 和 display-name。初始化会创建提交的 .waypoint/config.yaml 用于共享本地模式配置，创建被忽略的 .waypoint/local.yaml 用于当前参与者，并在注册 Feature 后创建提交的 .waypoint/tracker/features/ 记录，同时生成针对本地身份和锁文件的精确忽略规则。不得存储凭据、令牌、Cookie 或密码。.waypoint/local.yaml 标识当前参与者，但不会自动将所有权分配给无关 Feature。不得从 Git 作者元数据、执行环境、机器、分支或窗口标签推断所有权。
注册和解析 Feature：在持久 Feature 记录存在且负责人已知后，使用 register-feature 命令注册，提供 id、title、summary、owner，可选 milestone 和 path。使用 list-features 命令可按 --mine 或 --owner 过滤活跃 Feature。Feature 记录包含稳定 ID、负责人、可选里程碑分组、文档路径、Feature 状态、完成证据和修订版本，不包含子任务记录、指派人、执行者、分支、MR、阻塞项或任务状态。当省略目标时，从显式请求或 .waypoint/local.yaml 解析参与者，然后按负责人过滤活跃 Feature 记录；仅当恰好一个候选匹配时继续，没有或多个匹配时应询问。不得回退到其他参与者的 Feature、就绪队列头部、最近编辑、Git 历史或分支命名。选定 Feature 后，任务细节应使用其自身的 feature.md、feature.yml、任务计划或外部追踪器。
更新 Feature 状态：每次变更都需指定确切的 Feature 并提供预期修订版本。可用 transition-feature 转换状态，replan-feature 重新规划里程碑或路径，close-feature 关闭 Feature 并附上确认人、证据和完成日期，render 渲染视图，check 检查。任务规划仍属于 Feature 拥有的持久工件；如果团队需要实时任务分配或状态，应将该数据附加到 Feature 拥有的工件或使用配置的外部追踪器。本工具不会创建第二个任务状态存储或 .waypoint/tracker/tasks/ 权威。升级现有仓库时，旧版 .waypoint/tracker/tasks/ 记录不会被新脚本读取；应在选定的 Feature 拥有或外部权威中保留所需的任务契约或状态，然后在单独审查的变更中移除过时记录。
渲染人类视图：在接受的 Feature 状态变更后运行 render，仅更新生成的标记区域，包括按里程碑分组的全局 Feature 仪表板（当所有 Feature 均为独立时则为扁平列表），以及 docs/work/completed.md 中按最新优先排列的已完成 Feature 索引，仅包含日期、Feature 链接和可选的一行结果。仪表板以 Feature 为先且对负责人可见，不汇总或重写子任务。完成后报告更改的记录、修订版本、生成的视图以及任何同步限制。feature-close 负责周围的验收审计和关闭决策；本追踪器仅执行其确切的 Feature 状态转换并渲染视图。不得修改 Feature 契约、运行实现、合并 MR 或删除分支/worktree。
使用方式 从仓库根目录运行脚本，命令格式为 python3 <skill-path>/scripts/waypoint_tracker.py <command>。初始化使用 init --actor <stable-id> --display-name <name>。注册 Feature 使用 register-feature --id <feature> --title <title> --summary <one-line outcome> --owner <actor> [--milestone <milestone>] --path <feature.md>。列出 Feature 使用 list-features --mine --active-only 或 list-features --owner <actor> --active-only。状态变更使用 transition-feature、replan-feature、close-feature，并始终提供 --expect-revision。渲染使用 render，检查使用 check。在更改生成的路径或记录语义之前，应阅读 references/local-tracker-format.md。
适用场景 适用于没有外部追踪器、需要本地 Feature 负责人索引的团队；需要防止本地智能体窗口误选他人 Feature 的场景；需要以 Git 提交方式记录 Feature 所有权、状态和完成证据的仓库。
限制 该工具不提供跨未同步机器或 Git worktree 的强原子所有权；如果需要自主并发认领，应使用一个追踪器协调器进行共享变更，或使用外部追踪器。它不存储凭据，不推断所有权，不创建任务状态存储，不读取旧版任务记录，不修改 Feature 契约、不运行实现、不合并 MR、不删除分支或 worktree。它要求显式调用，不会隐式触发。