teach-oh

/teach-oh

收集项目背景并将其写入 AGENTS.md。在开始处理项目，或策略、目标或约束发生变化时运行。

适用场景

• 开始一个新项目
• 在不同会话之间持续丢失背景信息
• 主要战略目标或约束发生变化

不适用场景： 正在执行任务时。这是准备工作，不是执行工作。

按需参考资料

• 仅当用户询问 AGENTS.md 的输出应是什么样时，才加载 references/examples.md。
• 仅当 AGENTS.md 背景信息已拟定，且用户需要可选的 OMP 或 Claude Code hooks/agents 时，才加载 references/install.md。
• 如果需要 RNA 设置，请使用 /setup；不要在此处直接写出安装命令。

流程

第 1 步：先探索，再提问

查找可以提供以下信息的工具和文件：

• 项目结构和技术栈；
• 软件包、构建和 CI 配置；
• 现有的 AGENTS.md、CLAUDE.md、README、CONTRIBUTING、.oh/、ADR；
• 模式、约定和近期提交；
• 敏感区域或已记录的约束。

不要询问你可以自行发现的信息。

第 2 步：只问重要的问题

针对无法推断的信息提出有针对性的问题：

目的与目标

• 这个项目旨在实现什么？
• 谁会使用它？出现什么行为变化才算成功？
• 当前优先事项是什么？

战略约束

• 哪些约束绝不能妥协？
• 有哪些权衡是经过有意取舍的？
• 明确不在范围内的事项有哪些？

决策背景

• 在这里如何做出决策？
• 什么情况才算「完成」？
• 哪些模式或实践是必须坚守的？

理解与重新定位

• 出现哪些信号，意味着当前的叙事已不再符合现实，需要暂停并重新审视？
• 谁或什么可以指出偏离、提出异议、决定挽救或重新审视？
• 哪些决策在做出承诺前必须听取异议？
• 哪些失败应触发挽救，而不是继续执行？
• 哪些角色边界应保持清晰（实现者、审查者、异议者、领域专家、最终决策者）？
• 哪些证据可以推翻计划（测试、利益相关者反馈、运行信号、领域专业知识）？
• 哪些本地 metis 或护栏应在不同会话之间延续？

应避免的事项

• 不应重蹈覆辙的过往错误
• 不适用的诱人模式
• 代码库中的敏感区域

第 3 步：拟定持久背景信息

提议追加或更新 AGENTS.md。内容应适合作为工作背景，而不是文档。

包括：

• 用户希望在代码库中记录 OH 技能时，加入 Open Horizons Framework；
• 始终加入 Project Context：目的、目标、约束、模式、反模式、决策背景和理解规范。

写入前先将草稿交给用户审批。

输出格式

## Teach-OH Summary

### What I Discovered
- Stack: [technologies found]
- Structure: [key patterns observed]
- Existing context: [what docs already exist]
- Current focus: [what recent code/docs imply]

### Questions I Have
1. [Question about aims/strategy]
2. [Question about constraints]
3. [Question about decision practices]

---

After your answers, I'll draft an AGENTS.md section for your approval.

用户回答后：

## Proposed AGENTS.md Addition

[Draft the requested Open Horizons Framework section, if applicable]

[Draft the Project Context section]

---

**Write to AGENTS.md?** [Yes/No - show what will be added/updated]

完成说明

AGENTS.md 获批并写入后，仅当环境支持时才可选择性地提供安装帮助。背景信息保存在 AGENTS.md 中；保持内容精简，并在目标变化、约束改变或背景信息显得过时时重新运行。