by 运行时依赖
安装命令
点击复制技能文档
反思 — 学习 + 回顾 + 编写技能 三种模式：捕获学习（默认）、每周回顾或将重复模式编码为技能。 规则标签：[IRON LAW] 表示不可商量的正确性约束。 [GUIDANCE] 表示可能根据上下文进行调整的强默认值。 模式选择 学习（默认）："我们学到了什么"、"添加学习"、"显示学习"、"修剪学习" 回顾："每周回顾"、"我们发布了什么"、"回顾" 或 --retro 标志 编写技能："编写技能"、"创建技能"、"编码此模式"、"编辑此技能" 学习模式 仅捕获用户明确想要保留的内容，以便将来会话可以重用它。 调用规则 [IRON LAW] /taku-reflect 是手动的。除非用户明确调用反思，否则不要创建或更新长期学习。 存储 学习内容存储在 .taku/learnings/{project-slug}.jsonl 中。 每行：{"id":"L2026-04-21-001","timestamp":"2026-04-21T12:00:00Z","type":"preference/high","context":"多文件存储库更改","learning":"用户更喜欢在非平凡编辑之前进行计划","action":"从代码阅读和短执行计划开始","apply_when":{"task_types":["功能","重构","错误修复"],"keywords":["多文件","计划","设计"]},"status":"active"} 类型 每种类型都包括一个置信度后缀：/high、/medium 或 /low。 pattern — 一种可重用的方法，效果良好 pitfall — 需要避免的错误 preference — 用户声明的偏好或约定 discovery — 关于代码库的非明显见解 置信度含义： high — 经过测试或用户确认 medium — 观察到的模式，可能正确 low — 假设，需要验证 必填字段 自动生成（无需用户确认）： id — 稳定的标识符，自动生成为 L{date}-{seq} timestamp — ISO8601 UTC，自动生成 status — 默认为 active；仅在 PRUNE 期间更改 用户确认： type — pattern|pitfall|preference|discovery，带有置信度后缀（例如 pattern/high、pitfall/medium） context — 这个学习来自哪项工作 learning — 可重用的收获 action — 未来会话应该执行的操作 apply_when — 任务类型和关键词，以便稍后回忆（task_types + keywords） 脚本支持的操作 使用 scripts/learnings.py 进行所有学习文件操作。除非脚本不可用且用户明确批准回退，否则不要手动编辑 .taku/learnings/*.jsonl。 添加：收集类型（带有置信度后缀）、上下文、学习、操作和最小 apply_when 值。仅在用户确认学习应该保留后追加。 python3 /scripts/learnings.py add --project-root . --type preference/high --context "..." --learning "..." --action "..." --task-types 功能，重构 --keywords 计划，设计 搜索：通过脚本查询现有的学习，并在有用时按类型分组显示匹配项。 python3 /scripts/learnings.py search --project-root . --query "计划" --task-type 功能 --keywords 计划，设计 修剪：使用脚本列出过时或低置信度的候选项。显示每个标记的条目：删除 / 保留 / 更新。不要自动删除。 python3 /scripts/learnings.py prune --project-root . --days 30 导出：通过脚本将其转换为 markdown。仅当用户确认升级时，提供将导出的内容追加到 AGENTS.md 或 CLAUDE.md 的选项。 python3 /scripts/learnings.py export --project-root . 为什么选择 JSONL 而不是 markdown：JSONL 条目可以使用 grep 搜索，程序化解析和去重。markdown 学习文件变成难以查询或修剪的非结构化文本。 自动回忆 其他 Taku 阶段可能会自动搜索现有的学习，但仅作为上下文： 在任务分类后和 PLAN、BUILD、REVIEW 和 VERIFY 之前使用 scripts/learnings.py search 按任务类型和简单关键词重叠进行筛选 首先显示高置信度，然后显示中置信度 最多显示 3-5 个相关学习 此回忆必须永远不会创建、编辑或修剪学习。长期内存更改仅发生在 /taku-reflect 内。 项目引导 在项目的第一次成功反思运行中，检查项目级别的指令文件是否宣传可选的 Taku 学习协议。 何时检查：.taku/ 已经存在或此反思运行即将创建 .taku/learnings/{project-slug}.jsonl 运行 python3 /scripts/learnings.py bootstrap-check --project-root . 将结果视为建议 目标选择： 如果仅存在 AGENTS.md，建议在其中安装协议 如果仅存在 CLAUDE.md，建议在其中安装协议 如果两个文件都存在，建议在两个文件中安装相同的协议块，以便非 Taku 会话不依赖于加载哪个项目指令文件 如果一个文件已经有块而另一个文件没有，建议仅安装缺失的文件 如果两个文件都不存在，则不自动创建一个；请注意，没有项目级别的引导目标。