用途:wt-idea 用于在想法尚未成熟、还不能进入 wt-ready 时,先捕获并丰富它。目标是保留足够的证据与上下文,使后续 wt-ready 能据此生成最佳的任务或工作流计划。它不实现代码、不创建 TaskDocuments、不创建工作流、不启动 worktree,也不决定最终范围;想法到任务的转换交给 wt-ready,执行交给 wt-start,运行协调交给 wt-coordinate,已评审工作交给 wt-land。
主要能力:捕获用户原始意图、用户或客户问题与期望结果、本地产品/代码/文档上下文、相关已有想法/任务/工作流/issue/文档、外部最佳实践参考、可能方案及权衡、待验证假设、风险与兔子洞、明确的非目标、留给后续 HITL 或 wt-ready 的开放问题,以及下一步建议(继续丰富、运行 wt-ready、推迟或归档)。强调信息密度而非过早确定,不强迫过早锁定单一方案。
使用方式:先检查本地事实再提问,例如运行 git status --short --branch、查找 AGENTS.md、列出 git-common-dir 下 wt/ideas、wt/tasks、wt/workflows 的文件、查看 wt config。禁止读取 .env 等秘密文件。若 <git-common-dir>/wt/ideas 不存在,仅在保存新想法时创建。搜索已有本地产物可用 rg 在 ideas、tasks、docs、app、resources、tests 中检索关键词。当用户要求最佳实践、涉及当前工具/框架或仅凭仓库无法判断方向时,使用外部研究,优先官方文档、权威方法说明、源码仓库、标准与厂商文档,并在想法正文记录 URL。
状态模型:captured(原始想法,上下文极少)、enriched(已收集本地/外部上下文与备选方案)、ready_for_wt_ready(信息足够 wt-ready 准备任务/工作流)、converted(已被 wt-ready 转换)、archived(有意暂不推进)。做了有意义研究时默认 enriched;只有范围、未决问题和下一步检查足够清晰时才用 ready_for_wt_ready。
文件格式:想法存于 <git-common-dir>/wt/ideas/<date>-<slug>.toml,slug 用小写 ASCII kebab-case;已存在则更新而非重复创建。只用简单顶层 TOML 字段,丰富规划上下文放在 body 中,字段包括 title、status、created_at、updated_at、source、tags 和 body。除非本地 schema 明确采用,否则不加嵌套 TOML 表。
提问与交接:仅当不回答就无法安全捕获时才提问,否则把不确定性记为开放问题继续;一次最多问一个聚焦问题并给出推荐默认值。结束时给出想法文件路径、状态、已检查证据、发现的重复或相关产物、是否已准备好进入 wt-ready 的原因,以及确切的下一步技能调用或目标,例如 $wt-ready <git-common-dir>/wt/ideas/YYYY-MM-DD-slug.toml。若用户只要求列出或评审想法,除非明确要求注册或更新,否则不写文件。
限制:不实现代码、不创建 TaskDocuments 或工作流、不启动 worktree、不决定最终范围;不读取秘密文件;不编造未提供的事实。