docs: update teacher Agent consensus for personal cyber mapping

This commit is contained in:
鲨鱼辣椒 committed 2026-10-08 17:37:17 +08:00
1 parent 753eb6ca7e
commit 00db469aea
6 files changed
+84 -17

No files matched your search

+36 -14
View File
@@ -30,32 +30,54 @@ A good solution should {quality bar}.
## 老师 Agent 的产品定位 ## 老师 Agent 的产品定位
用户确认日期:2026-09-26。 用户确认日期:2026-10-08。本轮共识更新了 2026-09-26 的定位;后续老师 Agent 建设以本节为准。
老师 Agent 是某一领域杰出人物的能力转化而成的智能体,供平台学生用户使用。 **老师 Agent 是现实中某位具体老师量身打造的赛博版本。用户通过这个 Agent,与这位老师的见解、经验、判断和做事方式建立连接。** 例如 Alice 对应 Alice Agent,映射对象是 Alice 本人。
产品定义的重点是承载谁在什么领域的哪些能力,以及这些能力能为学生提供什么价值。蒸馏属于能力转化的一种实现方法。 ### 核心价值与映射范围
### 能力来源与内涵 人的见解与经验是老师 Agent 的核心价值。即使使用相同的 AI 工具,不同人的关注点、问题定义、判断标准、取舍与修正方式,也可能带来不同结果。提炼应关注这些差异如何在具体情境中产生作用,以及何时不再适用。
能力来源于在特定领域具有杰出能力的人。每位老师 Agent 应明确能力来源、擅长的领域、所承载的能力及其适用边界。 映射范围包括语言风格、思维与判断方式、工作习惯、擅长能力,以及支撑这些能力的知识和经验。例如抓重点、追问价值、辨别关键证据、决定先做什么、根据反馈改变方向。表达方式是本人映射的重要组成部分;能模仿措辞或口头禅,尚不足以证明保留了其见解和判断。
这些能力包括对领域问题的理解、专业经验、观察方式、判断标准、取舍方法和解决问题的能力。在具体问题中,学生应能获得这些能力带来的帮助,例如识别关键问题、理解判断依据、比较可行方向,以及根据新事实调整判断。 可以存在许多老师 Agent,每位都有自己的特点。“杰出人物”不作为创建门槛。**“是谁的分身”与“在 Code 模块承担什么职责”分别定义**,不同老师可以承担不同职责,具体职责应与其专长和已验证范围相符,不预设所有老师遵循同一教学人设或工作流程。
### 提供给学生的价值 ### 用户通过 Agent 建立连接
学生带着项目、作品或困惑使用老师 Agent,获得领域杰出人物的能力支持,包括具体的专业判断、判断依据及可考虑的下一步,并逐步理解其思考和解决问题的方法。不同老师提供不同领域的能力与专长,学生保留自己的选择和决定权。 用户带着项目、作品和问题,与具体老师的 Agent 持续交流,获得有个人特点的观察、判断依据、经验和行动建议,并在交流中逐步理解这位老师的思考与做事方式。用户保留自己的选择和决定权。
例如,游戏设计领域可以判断玩法是否成立、反馈是否清晰;创作领域可以判断表达是否准确、作品特点是否形成。这些是能力方向示例,具体智能体的适用范围需由其能力定义和案例验证确定。 “连接”应在真实问题和持续协作中体现,不能只依靠头像、姓名或一次相似回答来证明。Agent 的回答也不自动等同于真人老师对这次问题作出的即时答复或承诺。
### 实现方式与能力验证 ### 显性知识、隐性知识与上下文知识库
能力总结、提炼和蒸馏,以及提示词、Skill、案例与知识,属于把人的领域能力转化为 Agent 能力的实现方式和载体。具体实现服务于上述定义,名称、头像与表达风格用于呈现身份。 建设同时关注能明确表达的知识,以及体现在实践中的经验、识别线索、判断和习惯。隐性知识并不都能完整转成文字;需要结合真实行为、案例、过程与结果,检验提炼出的描述能否在新情境中发挥作用。语言学、行为学、心理学和专家知识提取方法可以作为分析视角,具体方法尚待选择与验证。
能力验证关注学生面对新的真实问题时,智能体是否体现所承载的领域能力:能否给出有辨识度、有依据、有帮助的判断与解决思路,说明取舍和适用条件,并在信息不足时明确能力与判断的限制。这是后续能力建设和验收标准;本次定义确认不表示现有所有下发智能体已经完成此类验证。 形成上下文知识库是建设方向。应保留原始证据、典型案例、见解与判断依据、适用情境、条件、例外和工作方法之间的联系,并能够追溯来源、时间及老师确认状态。需要区分本人原话、本人确认的提炼与系统推断,也区分事实、个人立场、经验规则和待验证假设;AI 推断不能未经确认就成为“老师的见解”。
### 产品定位与交付机制 老师相对长期的知识与判断、用户及项目的历史、当前任务事实需要分别组织并在使用时结合。老师纠正、版本更新和真实协作反馈可用于持续校准;用户反馈先作为候选材料,不直接改写老师的观点。具体知识结构、检索、记忆或训练方案未定。
云端管理、运营下发、项目和会话读取与聊天共同支持上述能力的交付。客户端统一承载服务端下发的智能体,“老师”“朋友”“方法教练”等名称和人设由云端配置决定,不新增固定角色分类或按名称分配权限。 ### 提炼入口与研究边界
候选材料包括老师授权提供的真实工作记录(例如常用工具中的 Codex 对话)、访谈、选择题与开放问答、情境题、真实案例复盘,以及老师完成的轻量项目。它们可组合使用,用于观察“说自己会怎样做”与“实际怎样做”,目前不指定统一题库或固定提炼顺序。本次共识不表示已经取得个人记录或具备自动导入能力。
专家知识提取研究,如 [Critical Decision Method](https://doi.org/10.1109/21.31053) 和 [ACTA](https://doi.org/10.1080/001401398186108),可为案例追问、关键线索和判断过程的提炼提供参考。[隐性知识研究](https://press.uchicago.edu/ucp/books/book/chicago/T/bo8461024.html)提示完整表达存在边界;[基于个人自述的 Agent 模拟研究](https://arxiv.org/abs/2411.10109)不能直接证明教师专业能力已迁移或整个人已被完整还原。这些是方法参考与证据边界,不构成本产品的效果验收。
本节“蒸馏”指从真人材料中提炼并构建可运行、可校准的老师 Agent,不预设必须采用模型训练中的知识蒸馏技术。
### 真人映射验收与用户价值评估
**老师本人需要参与确认赛博映射是否做好。** 可通过题库、问答和情境任务,比较 Agent 的语言风格、问题关注点、判断依据、取舍、经验运用、工作习惯,以及条件变化后的调整是否符合本人。
提炼材料与验收材料应分开,保留未用于提炼的新题。老师与 Agent 在相同背景下独立作答,再由老师评估;必要时追问依据、改变条件或观察任务过程。验收允许本人认可的合理表达与判断差异,不要求逐字一致,也不把老师某一次回答当成在所有情境下唯一正确的答案。发现偏差后校准,并用新的题目复测。
验收结果应说明 Agent 版本、评估维度、适用情境与已验证职责。具体题型、题量、评分、权重和通过门槛仍待讨论。老师本人认可映射,是验证个人特征的重要环节,不能单独证明专业判断正确或用户效果良好。
用户实际获得的价值需要另行评估:在新问题中是否得到有依据、有辨识度、有帮助的判断,能否理解其思路并形成持续连接,是否知道判断的条件与限制。用户满意度、项目成果或教学效果,也不能替代老师本人对映射的验收。
### 已确认方向与后续方法论
以上确认了真人映射、见解与经验、用户连接、上下文知识库和本人参与验收的方向。下一步围绕一位具体老师及其明确职责,讨论材料采样、提炼流程、证据核对、知识组织、校准和验收方法,再通过试验验证。老师建议与操作 Agent 的交接及执行反馈如何形成闭环,也属于后续方案。
本节记录产品共识,不表示现有下发智能体已经完成真人映射、知识提炼或上述验收。提示词、Skills、案例、知识和模型配置是候选承载方式,具体组合尚待验证。现有云端管理、运营下发、项目连续聊天、版本绑定与只读工具边界保持;客户端统一承载发布配置,不按“老师”“朋友”等名称另设角色权限,也不增加固定教学基线。
本节作为老师 Agent 产品理念的权威记录;既有技术与运行边界见[老师 Agent 决策](../10-decisions/ADR-2026-09-22-coding-teacher.md)。 本节作为老师 Agent 产品理念的权威记录;既有技术与运行边界见[老师 Agent 决策](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
@@ -6,7 +6,7 @@
## Product Positioning ## Product Positioning
2026-09-26 用户明确确认并进一步澄清:老师 Agent 是某一领域杰出人物的能力转化而成的智能体,供平台学生使用。定义以人的领域能力及学生价值为中心,蒸馏属于实现方法。能力来源、能力内涵、学生价值与真实案例验证标准集中记录在[产品定位](../00-brief/project-positioning.md#老师-agent-的产品定位)。下列云端执行、上下文读取与咨询交互决定服务于这一能力交付;客户端统一智能体模型保持。 2026-10-08 用户确认更新定位:老师 Agent 是现实中某位具体老师量身打造的赛博版本,核心价值是本人的见解、经验和判断,用户通过 Agent 与这位老师建立连接;语言风格、思维方式、工作习惯与专长共同参与映射,不同老师可承担不同职责。老师本人通过题库、问答或情境任务参与映射验收,用户实际价值另行评估。该共识取代原“领域杰出人物的能力转化”定位,完整内容及上下文知识库方向、研究边界和待讨论方法论见[产品定位](../00-brief/project-positioning.md#老师-agent-的产品定位)。本次仅更新产品共识,不宣称映射或验收已实现;下列已实现的云端执行、上下文读取、咨询交互与客户端统一智能体模型保持。
## Decision ## Decision
+1 -1
View File
@@ -6,7 +6,7 @@
- 2026-09-29 修订[下发智能体咨询决定](ADR-2026-09-22-coding-teacher.md):Yuxi 一次发布保持稳定老师身份;客户端五秒前台 revision 检查、入场/焦点刷新独立于聊天状态,保留项目连续聊天和运行快照。 - 2026-09-29 修订[下发智能体咨询决定](ADR-2026-09-22-coding-teacher.md):Yuxi 一次发布保持稳定老师身份;客户端五秒前台 revision 检查、入场/焦点刷新独立于聊天状态,保留项目连续聊天和运行快照。
- 2026-09-26 已确认[老师 Agent 产品定位](../00-brief/project-positioning.md#老师-agent-的产品定位):某一领域杰出人物的能力转化而成的智能体,供平台学生使用;蒸馏属于实现方法,以真实案例验证领域能力;补充下方既有咨询技术决定。 - 2026-10-08 更新确认[老师 Agent 产品定位](../00-brief/project-positioning.md#老师-agent-的产品定位):具体真人量身打造的赛博老师,以本人见解、经验和判断为核心,让用户通过 Agent 建立连接;不同老师可承担不同职责。老师本人参与题库/问答等映射验收,用户价值另行评估;上下文知识库是建设方向,具体蒸馏与评分方法待讨论。取代原产品定位,既有咨询技术边界保持,不代表真人映射已实现。
- [下发智能体咨询与项目会话导航](ADR-2026-09-22-coding-teacher.md):2026-09-28 amended / implemented;按用户纠正,唯一持续聊天身份为账号+项目+下发智能体,不同项目隔离历史、草稿、已读与模型上下文,保留同项目无新话题入口的交互。Pi 来源/发布版本在每轮接受时冻结,同项目变化只轮转内部线程。旧全局聊天按每轮可证明的项目分入对应会话,保留原文件并开启新云端执行段;不明归属仅保留原档案。学生计费、统一只读工具和主线程正文保持;老师对话使用 reply-v1 正文与 0–3 条可选快捷回复,退役组件仅留原档案;本地恢复完整旧正文,无法完整恢复时显式重试且保留草稿;主动观察建议接入由独立任务继续并绑定对应项目。 - [下发智能体咨询与项目会话导航](ADR-2026-09-22-coding-teacher.md):2026-09-28 amended / implemented;按用户纠正,唯一持续聊天身份为账号+项目+下发智能体,不同项目隔离历史、草稿、已读与模型上下文,保留同项目无新话题入口的交互。Pi 来源/发布版本在每轮接受时冻结,同项目变化只轮转内部线程。旧全局聊天按每轮可证明的项目分入对应会话,保留原文件并开启新云端执行段;不明归属仅保留原档案。学生计费、统一只读工具和主线程正文保持;老师对话使用 reply-v1 正文与 0–3 条可选快捷回复,退役组件仅留原档案;本地恢复完整旧正文,无法完整恢复时显式重试且保留草稿;主动观察建议接入由独立任务继续并绑定对应项目。
@@ -4,6 +4,8 @@ This file is the integrated default-branch snapshot. Feature tasks record progre
## Integrated Through ## Integrated Through
- 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)。 - 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)。
- 2026-09-29:按用户要求,将老师流式源 `8ccc4650a2d36ea4a1a7426dbaffc8178255a5e3` 从 `f443f3b` 无冲突快进合入本地 `main`。Yuxi 主线程思考独立流式显示并保存,正文从未完成结构化回复逐步投影,最终回复确认正文与快捷回复;思考不进入工具活动、后续模型上下文或带回草稿。工具续接与取消保留已收内容,子线程仍只推进游标。产品与测试保持源一致,沿用 322 项相关单测、标准类型检查、lint、生产构建及 1 项 Electron 场景证据;扩展 Main 仍有 66 项既有诊断。已核对 Yuxi 现有事件协议,无配套服务端改动;需更新客户端,真实模型思考事件与安装版尚未验收。三份外来文档原样保留且未提交;未推送、部署或打包。见[源记录](tasks/20260929-teacher-stream-f00acb6f.md)和[集成记录](tasks/20260929-merge-teacher-stream-1e4177fe.md)。 - 2026-09-29:按用户要求,将老师流式源 `8ccc4650a2d36ea4a1a7426dbaffc8178255a5e3` 从 `f443f3b` 无冲突快进合入本地 `main`。Yuxi 主线程思考独立流式显示并保存,正文从未完成结构化回复逐步投影,最终回复确认正文与快捷回复;思考不进入工具活动、后续模型上下文或带回草稿。工具续接与取消保留已收内容,子线程仍只推进游标。产品与测试保持源一致,沿用 322 项相关单测、标准类型检查、lint、生产构建及 1 项 Electron 场景证据;扩展 Main 仍有 66 项既有诊断。已核对 Yuxi 现有事件协议,无配套服务端改动;需更新客户端,真实模型思考事件与安装版尚未验收。三份外来文档原样保留且未提交;未推送、部署或打包。见[源记录](tasks/20260929-teacher-stream-f00acb6f.md)和[集成记录](tasks/20260929-merge-teacher-stream-1e4177fe.md)。
@@ -0,0 +1,43 @@
# Task: Integrate approved teacher cyber mapping product consensus
## Identity
- Task ID: 20261008-teacher-consensus-integration-a9c2d7e1
- Mode: Integration
- Branch: main
- Worktree: /Users/chillishark/Makelore 麦洛/makelore
- Base commit: 753eb6ca7e743433d2fc55ee47a9bcbe2b6447c5
- Owner: codex
- Status: Ready for Integration
## Scope
- Integrate the explicitly approved teacher Agent consensus into product positioning, README, the teacher ADR, decision index and current integrated state.
## Intent And Constraints
- User confirmation on 2026-10-08 replaces the old exceptional-person capability-transfer positioning with bespoke real-teacher mapping, insights and experience, user connection and teacher-led mapping acceptance.
- 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.
## Outcome
- Canonical consensus now defines the specific real-person mapping, core insights and experience, individual styles and duties, and the user connection.
- 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.
## 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.
## Follow-ups
- Discuss distillation methodology using one concrete teacher and a bounded responsibility. No new task worktree cleanup or external publication is requested.
## Promotion Candidates
- Applied the user-approved positioning proposal to the canonical documents listed in Scope; no further promotion pending from this task.
+1 -1
View File
@@ -166,7 +166,7 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
顶部智能体名单旁的刷新按钮只显示图标,可立即获取最新下发名单、发布资料和当前版本,独立于主动关心的检查条件。刷新时图标旋转;悬停提示和无障碍状态提供刷新进度、成功或失败信息,失败保留原名单并可重试;顶部和已打开的咨询面板使用同一份结果。刷新不发起模型请求、不切换当前智能体、不清除草稿或历史,运行中的问题保留已绑定版本,下一次提问由 Main 固定当时的发布版本,同一聊天保持连续。 顶部智能体名单旁的刷新按钮只显示图标,可立即获取最新下发名单、发布资料和当前版本,独立于主动关心的检查条件。刷新时图标旋转;悬停提示和无障碍状态提供刷新进度、成功或失败信息,失败保留原名单并可重试;顶部和已打开的咨询面板使用同一份结果。刷新不发起模型请求、不切换当前智能体、不清除草稿或历史,运行中的问题保留已绑定版本,下一次提问由 Main 固定当时的发布版本,同一聊天保持连续。
老师 Agent 是某一领域杰出人物的能力转化而成的智能体,供平台学生使用,在真实项目、作品和问题中提供专业理解、判断与解决问题的能力支持。定义以人的领域能力及学生价值为中心;蒸馏属于实现方法,云端下发、上下文读取和聊天是能力交付方式。完整理念见[老师 Agent 产品定位](.project-docs/00-brief/project-positioning.md#老师-agent-的产品定位)。 老师 Agent 的产品共识是为现实中每位具体老师量身打造赛博版本,保留其见解、经验、语言风格、判断方式、工作习惯与专长,让用户通过 Agent 与这位老师建立持续连接。不同老师可以承担不同职责。后续由老师本人通过题库、问答或情境任务验收映射质量,并另行评估用户实际价值;上下文知识库与具体蒸馏方法仍待设计、验证,不表示现有下发智能体已经完成真人映射。完整共识见[老师 Agent 产品定位](.project-docs/00-brief/project-positioning.md#老师-agent-的产品定位)。
- 可在顶栏选择运营下发的 Yuxi 智能体,首次默认使用指定智能体;提示词、Skills、知识库和模型配置由 Yuxi 管理,运营同步后生成新版本,每轮接受问题时固定当前版本,历史轮次保留原版本。Yuxi 智能体模型费用由当前学生的编程词元点数支付,个人 Agents 模块仍由创建者付费;不要求学生开通个人云智能体模块。停用的智能体仍可查看历史,不能借另一位智能体的可用状态继续提问。 - 可在顶栏选择运营下发的 Yuxi 智能体,首次默认使用指定智能体;提示词、Skills、知识库和模型配置由 Yuxi 管理,运营同步后生成新版本,每轮接受问题时固定当前版本,历史轮次保留原版本。Yuxi 智能体模型费用由当前学生的编程词元点数支付,个人 Agents 模块仍由创建者付费;不要求学生开通个人云智能体模块。停用的智能体仍可查看历史,不能借另一位智能体的可用状态继续提问。
- Main 为智能体每轮请求绑定当前账号、项目和所选操作会话,提供 `list_project_files`、`read_project_file`、`read_conversation` 三个只读工具。云端通过持久中断请求整批读取,Main 返回配对结果并续接同一问题;若原运行仍在释放资源,保留同一批读取结果等待续接,等待期间仍支持取消并受原问题时限约束。本地旧版智能体也支持相同读取边界。可读当前项目源码及 `.makelore/project.json`,拒绝其他 `.makelore` 历史、Git 内部数据和越界路径;不提供写文件或命令执行。这些能力不按名称或人设区分。 - Main 为智能体每轮请求绑定当前账号、项目和所选操作会话,提供 `list_project_files`、`read_project_file`、`read_conversation` 三个只读工具。云端通过持久中断请求整批读取,Main 返回配对结果并续接同一问题;若原运行仍在释放资源,保留同一批读取结果等待续接,等待期间仍支持取消并受原问题时限约束。本地旧版智能体也支持相同读取边界。可读当前项目源码及 `.makelore/project.json`,拒绝其他 `.makelore` 历史、Git 内部数据和越界路径;不提供写文件或命令执行。这些能力不按名称或人设区分。