docs: require students to articulate adopted teacher advice
This commit is contained in:
鲨鱼辣椒 committed
1 parent
00db469aea
commit
07f009cd88
6 files changed
+23
-1
No files matched your search
@@ -48,6 +48,16 @@ A good solution should {quality bar}.
|
||||
|
||||
“连接”应在真实问题和持续协作中体现，不能只依靠头像、姓名或一次相似回答来证明。Agent 的回答也不自动等同于真人老师对这次问题作出的即时答复或承诺。
|
||||
|
||||
### 学生理解与执行表达
|
||||
|
||||
用户于 2026-10-08 补充确认：老师给出判断或建议后，学生需要自行理解、决定是否采纳，并用自己的表达向操作 Agent 提出目标与执行要求。学生的理解、选择和表达是建议进入执行过程的必要环节。
|
||||
|
||||
交互过程为：**老师提出判断与建议 → 学生理解并选择是否采纳 → 学生用自己的话向操作 Agent 表述 → 操作 Agent 根据学生表述执行 → 查看作品结果 → 老师基于可获得的结果继续判断。**
|
||||
|
||||
老师或系统不能通过直接转发建议、自动下发指令或一键采纳执行，替代学生自己的表述；仅点击“采纳／确认”也不能替代这一过程。学生仍可向老师追问、澄清和讨论，再形成自己的表达。
|
||||
|
||||
保留学生如何理解、转化和运用建议的表达，才能为判断学生是否理解提供依据。学生自己表述并不自动证明已经理解，作品执行成功也不能代替对理解的观察。具体观察与反馈方式待讨论。
|
||||
|
||||
### 显性知识、隐性知识与上下文知识库
|
||||
|
||||
建设同时关注能明确表达的知识，以及体现在实践中的经验、识别线索、判断和习惯。隐性知识并不都能完整转成文字；需要结合真实行为、案例、过程与结果，检验提炼出的描述能否在新情境中发挥作用。语言学、行为学、心理学和专家知识提取方法可以作为分析视角，具体方法尚待选择与验证。
|
||||
@@ -76,7 +86,7 @@ A good solution should {quality bar}.
|
||||
|
||||
### 已确认方向与后续方法论
|
||||
|
||||
以上确认了真人映射、见解与经验、用户连接、上下文知识库和本人参与验收的方向。下一步围绕一位具体老师及其明确职责，讨论材料采样、提炼流程、证据核对、知识组织、校准和验收方法，再通过试验验证。老师建议与操作 Agent 的交接及执行反馈如何形成闭环，也属于后续方案。
|
||||
以上确认了真人映射、见解与经验、用户连接、上下文知识库、本人参与验收，以及由学生理解并向操作 Agent 表述执行要求的方向。下一步围绕一位具体老师及其明确职责，讨论材料采样、提炼流程、证据核对、知识组织、校准和验收方法，再通过试验验证。后续协作与结果反馈设计须保留学生理解、转化并表达建议的过程，不设计老师建议直接交给操作 Agent 执行的路径。
|
||||
|
||||
本节记录产品共识，不表示现有下发智能体已经完成真人映射、知识提炼或上述验收。提示词、Skills、案例、知识和模型配置是候选承载方式，具体组合尚待验证。现有云端管理、运营下发、项目连续聊天、版本绑定与只读工具边界保持；客户端统一承载发布配置，不按“老师”“朋友”等名称另设角色权限，也不增加固定教学基线。
|
||||
|
||||
|
||||
@@ -10,6 +10,7 @@
|
||||
|
||||
## Decision
|
||||
|
||||
- 2026-10-08 用户补充确认产品交互边界：老师给出建议后，由学生理解、决定是否采纳，并用自己的表达向操作 Agent 提出目标和执行要求；老师或系统不得以直接转发建议、自动下发或一键采纳执行替代学生表达。查看作品结果后，老师再基于可获得的事实继续判断。学生表达是观察理解的依据，不能仅凭采纳或执行成功认定已理解；具体观察方法待讨论。本条为产品共识更新，未改动运行代码或既有历史记录。
|
||||
- 2026-09-29 远程输入区改动与本地流式回复合并：麦克风识别只追加当前草稿，不自动发送，账号／项目／老师／来源切换或关闭时取消过期结果。默认模型沿用老师发布配置；学生可在 Main 与云端能力允许时为后续手动问题显式选择模型，按账号／老师记忆。每轮固定 modelId 与请求身份，重试保持原选择；人设、资源、发布版本、项目边界和学生计费不变，主动检查仍使用云端配置。旧服务能力不足时明确不可用，不忽略选择；配套 WS/Yuxi 上线仍为独立发布工作。
|
||||
- 快捷提示放在输入框上方，云端文案／实际提示词及空列表兼容规则保持；回复卡片采用紧凑样式，普通问题和求助均在完成时间之后只显示一次。发送时间与完成时间来自真实记录，运行中显示状态，未知时间不伪造。默认求助兼容文案更新为“帮我整体看🧠”。
|
||||
- 每位下发老师分别显示介绍气泡，按账号／项目／老师保存已介绍状态和操作 Agent 的完整回复轮数。进入对应咨询或显式关闭仅消费这一位；未操作时于第三轮成功操作回复后收起，旧历史、老师咨询、失败或中间工具事件不计数。咨询期间介绍组收起，真实未读主动建议继续使用独立已读边界；没有目录的旧入口保留欢迎语兼容。
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Decision Index
|
||||
|
||||
- 2026-10-08 补充确认[学生理解与执行表达](../00-brief/project-positioning.md#学生理解与执行表达)：学生采纳老师建议后，须自己理解并向操作 Agent 表述目标与要求，老师或系统不直接交接建议触发执行；保留学生表达作为观察理解的依据，具体观察方法待讨论。
|
||||
|
||||
- [老师思考与回答流式展示](ADR-2026-09-22-coding-teacher.md)：2026-09-29 已合并；主线程思考独立保存与折叠展示，正文逐步投影并由最终回复确认，快捷回复仅完成后显示；思考不进入后续模型上下文、工具活动或带回草稿。
|
||||
|
||||
- [老师可配置快捷提示](ADR-2026-09-22-coding-teacher.md)：2026-09-29 已合并；Yuxi 有序展示文案/实际提示词，显式发布冻结，WS 版本化下发，客户端普通提问；空列表隐藏入口，历史缺字段保持旧入口。
|
||||
|
||||
@@ -4,6 +4,8 @@ This file is the integrated default-branch snapshot. Feature tasks record progre
|
||||
|
||||
## Integrated Through
|
||||
|
||||
- 2026-10-08 补充：用户明确纠正老师建议进入执行的方式。老师建议后，学生须自己理解、决定是否采纳并向操作 Agent 表述目标与执行要求；不通过老师／系统直接转发、自动下发或一键采纳执行替代学生表达。随后查看作品结果，老师再基于可获得的事实继续判断。学生表达为观察理解提供依据，不等于自动证明理解；具体观察方法待讨论。本次基于共识提交 `00db469` 同步[产品定位](../00-brief/project-positioning.md#学生理解与执行表达)、README、老师 ADR 和决策索引，替换原先将老师建议与操作 Agent 交接留待设计的表述；仅更新文档，未改动运行代码、配置或发布。见[同一集成记录](tasks/20261008-teacher-consensus-integration-a9c2d7e1.md)。
|
||||
|
||||
- 2026-10-08：按用户明确授权更新[老师 Agent 产品共识](../00-brief/project-positioning.md#老师-agent-的产品定位)。老师 Agent 为具体真人量身打造的赛博老师，核心是见解、经验与判断，用户通过 Agent 建立连接；不同老师可承担不同职责，映射包含语言、思维、习惯与专长。上下文知识库保留情境、来源与老师确认状态；由老师本人通过题库、问答或任务参与映射验收，用户实际价值另行评估。新共识更新下方 2026-09-26 的旧定位，具体蒸馏流程、题库和评分门槛待讨论。基于主线 `753eb6ca7e743433d2fc55ee47a9bcbe2b6447c5`，核对提案源提交 `5506922ba9e6528895eab965ef9beae3d7528ebe` 后同步产品定位、README、ADR 与决策索引；仅文档更新，未读取个人 Codex 记录、实现真人映射、修改运行配置或发布服务。见[集成记录](tasks/20261008-teacher-consensus-integration-a9c2d7e1.md)。
|
||||
|
||||
- 2026-09-29：续接用户已授权的老师流式集成任务，将远程 `a77ddbd6813bb71d490544edfef6e1f35240070f` 与本地 `6dee9ea62c42b98a747352378fe1c74ab77f48a5` 合并。保留独立思考／正文流，接入按请求固定的模型选择、语音草稿、真实时间戳、紧凑快捷回复和各老师独立介绍；完成态正文及卡片各显示一次。同步纳入本地空作品检测、社区外部链接和 macOS 主窗口重建。582 项相关单测、47 项浏览器场景、9 项 Electron 场景、标准类型检查、变更文件 lint 与生产构建通过；修正一处仍假设单欢迎气泡的旧布局断言。Windows 夹具不代表原生 macOS、真实模型或云端模型覆盖能力已上线。失效源工作树通过保留残留目录、官方 release-missing/start 恢复登记；三份原有未跟踪文档及远程来源记录保持原样。未推送、部署、打包或更新安装版。见[续接记录](tasks/20260929-merge-teacher-stream-1e4177fe.md#remote-merge-resume)。
|
||||
|
||||
@@ -13,6 +13,7 @@
|
||||
## Scope
|
||||
|
||||
- Integrate the explicitly approved teacher Agent consensus into product positioning, README, the teacher ADR, decision index and current integrated state.
|
||||
- Resume the same consensus task for the user's correction requiring student understanding and self-expression before operation Agent execution.
|
||||
|
||||
## Intent And Constraints
|
||||
|
||||
@@ -20,6 +21,7 @@
|
||||
- Documentation only. Preserve current runtime, published configurations and permissions. No personal Codex history access or distillation implementation.
|
||||
- Concurrent and Planning Gates passed. Required project memory, evidence/reflection/commitment indexes and peer scopes were read; related runtime tasks have no dependency on this prose change. One older child-language task has incomplete scope and is not a source for this integration.
|
||||
- Source proposal `5506922ba9e6528895eab965ef9beae3d7528ebe` exists in the shared Git repository; its completed source task record was reviewed read-only. Its exceptional-person positioning conflict is resolved by the user's explicit new direction. The source branch is retained without merging its administrative record.
|
||||
- The user explicitly rejects direct teacher-to-operation execution handoff. Do not infer an exam, automatic understanding score, execution gate or a ban on sharing project facts from this correction. Resumed ownership and Planning Gates passed; peer records were re-read without changes.
|
||||
|
||||
## Outcome
|
||||
|
||||
@@ -27,12 +29,15 @@
|
||||
- Recorded explicit/tacit knowledge and contextual evidence direction, candidate elicitation sources, primary research limits, and teacher participation in independent held-out mapping acceptance.
|
||||
- Kept user value separate from mapping fidelity and left concrete distillation, representation, scoring and release thresholds open for the next discussion.
|
||||
- Synchronized current product summaries without asserting runtime implementation or changing technical decisions.
|
||||
- Added the required student-owned step: understand the advice, decide whether to adopt it, and articulate the goal and execution requirements to the operation Agent. Direct forwarding, automatic dispatch or one-click adoption cannot replace this expression. Student expression is evidence for observing understanding, not proof of understanding.
|
||||
- Replaced the open-ended direct handoff proposal with this explicit boundary; retained result review and further teacher judgment based on available evidence. Updated the same five canonical documents, with no runtime changes.
|
||||
|
||||
## Verification
|
||||
|
||||
- Independent review passed: all confirmed points covered; detailed methodology remains open; research and implementation boundaries are explicit.
|
||||
- Project documentation structure check, task-aware integration drift check and `git diff --check` passed. Six consensus references resolve to existing local files and the stable positioning heading.
|
||||
- Inspected the complete positioning diff and all changed paths: five canonical documents plus this integration record, with no runtime changes. No runtime tests applicable to this prose-only update.
|
||||
- Resumed correction: independent semantic-boundary review, documentation structure, task-aware drift and whitespace checks passed. New student-expression references resolve and the superseded open handoff proposal is removed. Reviewed the complete canonical diff; only the same five documents and this own task record changed.
|
||||
|
||||
## Follow-ups
|
||||
|
||||
|
||||
Reference in new issue
Block a user