docs: 明确老师 Agent 的领域判断能力定位

This commit is contained in:
2026-09-26 15:25:00 +08:00
parent 1037356090
commit 9147b509c7
6 changed files with 46 additions and 1 deletions

View File

@@ -27,3 +27,33 @@ A good solution should {quality bar}.
## Last Reviewed
{YYYY-MM-DD}
## 老师 Agent 的产品定位
用户确认日期:2026-09-26。
老师 Agent 将在某些领域具有特殊能力的人的专业经验与判断方法进行总结、提炼和蒸馏,形成可下发给平台学生用户的智能体,为学生在这些领域遇到的真实问题提供判断能力。
### 能力来源与蒸馏内容
能力来源于在特定领域有独特能力、成熟经验和判断方法的人。每位老师 Agent 应明确能力来源、擅长的领域以及适用边界。
蒸馏重点包括:如何定义和观察问题、关注哪些证据、采用什么判断标准、如何权衡取舍,以及哪些新事实会使其改变判断。提示词、Skill、案例和知识共同承载这些方法;名称、头像与表达风格用于呈现身份,能力建设以领域判断质量为核心。
### 提供给学生的价值
学生带着项目、作品或困惑使用老师 Agent,获得具体的领域判断、判断依据及可考虑的下一步,并逐步理解这些判断方法。不同老师可以提供不同领域的观察角度与专长,学生保留自己的选择和决定权。
例如,游戏设计领域可以判断玩法是否成立、反馈是否清晰;创作领域可以判断表达是否准确、作品特点是否形成。这些是能力方向示例,具体智能体的适用范围需由其能力定义和案例验证确定。
### 能力建设与验证
建设路径:发现有特殊能力的人 → 提炼其判断方法 → 用真实案例验证 → 形成老师 Agent → 下发给学生使用。
能力验证关注学生面对新的真实问题时,智能体能否给出有辨识度、有依据、有帮助的领域判断,说明取舍与适用条件,并在信息不足时明确判断的限制。这是后续能力建设和验收标准;本次定位确认不表示现有所有下发智能体已经完成此类验证。
### 产品定位与交付机制
云端管理、运营下发、项目和会话读取、聊天与结构化讨论共同支持上述能力的交付。客户端统一承载服务端下发的智能体,“老师”“朋友”“方法教练”等名称和人设由云端配置决定,不新增固定角色分类或按名称分配权限。
本节作为老师 Agent 产品理念的权威记录;既有技术与运行边界见[老师 Agent 决策](../10-decisions/ADR-2026-09-22-coding-teacher.md)。

View File

@@ -1,9 +1,13 @@
# ADR: 官方编程老师与项目会话导航
- Status: Accepted / implemented, amended 2026-09-24
- Status: Accepted / implemented, positioning clarified 2026-09-26
- Date: 2026-09-22
- Approval: 用户确认项目默认 Agent、项目下会话、多老师列表与移除试聊;随后确认使用 Yuxi 原生智能体、客户端提供三个只读工具、沿用学生账号付费,并要求实施及合并。2026-09-24 明确取消客户端固定老师/朋友分类,统一使用后端下发智能体,并要求合并上下文预算修复。
## Product Positioning
2026-09-26 用户明确确认:老师 Agent 的产品核心是将特定领域中有特殊能力的人的判断能力提炼、蒸馏后,下发给平台学生,为真实问题提供领域判断。能力来源、蒸馏内容、学生价值与真实案例验证标准集中记录在[产品定位](../00-brief/project-positioning.md#老师-agent-的产品定位)。下列云端执行、上下文读取与咨询交互决定服务于这一能力交付;客户端统一智能体模型保持。
## Decision
- 新项目创建内部默认编程 Agent 并保存 defaultAgentId,会话直接列在项目下。打开项目不自动创建空会话,首次发送或显式新建才创建;历史 Agent ID、配置和 Pi 会话绑定保留。

View File

@@ -1,5 +1,7 @@
# Decision Index
- 2026-09-26 已确认[老师 Agent 产品定位](../00-brief/project-positioning.md#老师-agent-的产品定位):蒸馏特定领域优秀人才的判断能力,下发给平台学生,并以真实案例验证领域判断质量;补充下方既有咨询技术决定。
- [下发智能体咨询与项目会话导航](ADR-2026-09-22-coding-teacher.md):2026-09-24 amended / implemented;取消固定老师/朋友分类,运营下发 Yuxi 智能体并指定默认,发布定义拥有人设与显示资料,Main 提供一致的项目/会话只读工具。旧合成朋友话题与草稿只读保留;学生计费、版本固定与主线程正文路由保持,输入预算区分近似 Token 与精确 JSON 字节。
## Active Decisions

View File

@@ -4,6 +4,8 @@ This file is the integrated default-branch snapshot. Feature tasks record progre
## Integrated Through
- 2026-09-26:以已集成技术基线 `1037356090eca90793ffe74750c273cbb44d7aef` 为基础,按用户本轮明确确认,将[老师 Agent 产品定位](../00-brief/project-positioning.md#老师-agent-的产品定位)纳入产品文档:发现特定领域有特殊能力的人,提炼、蒸馏其判断方法,经真实案例验证形成老师 Agent,下发给平台学生提供领域判断。同步 README、老师 ADR 和决定索引;本次仅记录理念,不变更运行代码、线上配置或既有智能体角色模型,也不代表所有下发项已完成能力验收。
- 2026-09-24:从 `0e22e0545d6f58a17a8c85805570a550d1c14c43` 无冲突快进合入源 `79914e1d06a66f78239ebe57f816acc98dc1eaae`。智能体提交工具结果遇到同一 interrupted 父 Run 的临时 run_busy 时,Main 保留原批次等待资源释放后续接,不重读文件或新建问题,沿用取消与原问题时限;其他运行占用及冲突保持失败。产品/测试与源完全一致,沿用源 183 项相关测试及最终 29 项聚焦回归、Renderer 类型检查、scoped lint、Vite 构建和配套本地真实 HTTP/PG/worker 因果验证。原有 3 份文档保持,未推送、打包、安装或部署。详见[源任务](tasks/20260924-consultation-run-busy-9ac245f1.md)和[集成记录](tasks/20260924-merge-agent-rendering-ml-4efb196c.md);安装版/生产模型仍待验收。
- 2026-09-24:从 `39b03a1628bcdbc9c6bcf82b874e2814bf1780d0` 无冲突快进合入客户端源 `a10cf000157a1a3edcfad43705e0824f19568a33`。所有下发智能体在顶栏并排显示头像与名称,点击恢复对应历史或空输入框,数量多时横向滚动;移除面板智能体下拉框。草稿按账号/项目/智能体分别保存,旧未归属草稿只读折叠保留;旧话题版本、学生计费和三个只读工具保持。产品与测试文件和源完全一致,沿用源相关单测、17 项浏览器布局、1 项 Electron 交互及类型/lint/构建证据;本次只追加集成文档。3 份原有未提交文档保持,未推送、打包、安装或部署。详见[源记录](tasks/20260924-consultation-topbar-22717e99.md)、[集成记录](tasks/20260924-merge-agent-rendering-ml-4efb196c.md)和[咨询决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。

View File

@@ -12,11 +12,13 @@
## Scope
- 产品定位后续(2026-09-26):依据用户明确纠正并确认的理念,在 Makelore 产品定位、老师 ADR 和 README 记录“蒸馏有特殊领域能力的人的判断能力,形成老师 Agent,下发给平台学生使用”。这是既有智能体工作的产品定义澄清,仅更新文档。
- 工具续接后续集成(2026-09-24):合入已验证源 79914e1d06a66f78239ebe57f816acc98dc1eaae,修复同一 interrupted 父 Run 清理资源期间返回 run_busy 导致客户端取消问题。当前主线为源基线 0e22e0545d6f58a17a8c85805570a550d1c14c43。
- Merge reviewed source 97837cef90baf6bb02cfda0cef7b938081f3c5f7 (20260924-agent-rendering-a8c2d419) into local main; promote accepted consultation rendering and protocol facts. Paired Yuxi source: 02f27f33a8b816589036503f0720d446418c28aa.
## Intent And Constraints
- 定位记录的 Concurrent/Planning/Integration Gates Passed:官方同任务续接与所有权核验完成,重读入口、自身记录、产品定位、当前状态、老师 ADR、README 与相关规范;此前 116 个 peer 范围复用,登记在上次集成之后无活动。用户 2026-09-26 的纠正及“记录下这个定位和理念”已授权本次产品定位确认。计划:在 project-positioning 集中记录能力来源、蒸馏内容、学生价值、建设路径及真实案例标准,以 README/ADR 链接引用,同步当前状态并完成文档检查。保留客户端不固化老师/朋友分类、云端配置及三个只读工具的既有边界;不修改代码、线上配置或宣称现有智能体已通过领域能力验收。
- 本轮继续既有智能体集成任务;官方 same-task start/status 与独占 integration lock、Identity 匹配。Concurrent/Planning/Integration Gates Passed;重读 entry、自身/源记录、当前集成状态及老师决定/架构/领域/证据等上下文,复用未变的 115 个 peer 范围,刷新本次已完成源。历史模板记录没有本次具体语义依赖。3 份既有 adopted 文档保持原样。计划:精确快进、核对源字节与提交祖先、接受 current-state 提议、通过文档门禁、提交完成并询问源工作树清理。产品字节一致时沿用源测试,不重复已完成检查;不推送、打包、安装、部署或创建子智能体。
- Concurrent, Planning and Integration Gates Passed: official start/status match Identity and exclusive integration lock. Read entry/memory-index, own/source/reviewer records, positioning/current-state, teacher ADR, architecture, domain, evidence/reflection/commitments and registered peer scopes. Project goal remains server-distributed consultation agents, Main-owned read tools and student billing. No semantic conflict; preserve current workbench styling and guidance from main.
- User explicitly authorized official release --force of the prior integration owner and new --adopt-existing registration for three known foreign untracked task documents. They remain unchanged and excluded from commits. The new base avoids attributing old cross-machine imports to this integration. No registry fields were manually rewritten.
@@ -25,6 +27,7 @@
## Outcome
- 产品定位后续(2026-09-26):用户确认的老师 Agent 理念已集中写入 project-positioning,并由 README、老师 ADR、决定索引和 current-state 引用。核心是将有特殊领域能力的人的判断方法蒸馏并交付给学生;明确能力来源、蒸馏内容、学生价值、建设路径与真实案例验证标准。既有交互和云端能力边界保持,未修改任何运行代码或线上定义。
- 工具续接后续:main 从 0e22e0545d6f58a17a8c85805570a550d1c14c43 无冲突快进至 79914e1d06a66f78239ebe57f816acc98dc1eaae。产品、测试、README 与源一致;源任务记录原样导入,仅在本集成记录和 current-state 收录结果。接受原 Run 清理期间复用原工具批次、保留截止时间与取消的提议,不改变云端互斥或计费。
- Source merge committed as 98559e32a75dfbada12a737d7ff0ffda55aa346a. Before the merge commit the drift checker could not recognize the staged foreign source record; exact source-record equality was confirmed, then the unchanged source import was committed and the official drift check passed. No foreign record was edited/adopted to bypass this gate.
@@ -32,6 +35,7 @@
## Verification
- 定位记录:检查六个文档的差异与新增链接/标题目标,git diff --check 和官方 task-aware documentation drift 均通过;3 份 adopted 外来文档保持原样、未纳入提交。此次只有产品文档变更,未运行与内容记录无关的应用测试或构建,也未把理念确认表述为已下发智能体的能力验收结果。
- 工具续接后续:source ancestry、全部产品文件/source-record 精确相等、无 unmerged 路径检查通过。复用已验证源 183 项相关测试、最终 29 项聚焦回归、Renderer typecheck、scoped ESLint 与 Vite 全目标构建;配套 Yuxi 控制验证证明清理前 409、清理后相同批次 200 并完成回答。验证结果未被表述为新的重复测试或生产验收。官方文档门禁及 git diff --check 通过,3 份已 adopted 外来文档仍为原始状态;未改变产品或测试 oracle。
- Existing user-approved independent reviewer completed a bounded integration review: PASS, no findings. Of 19 source-changed files, 17 match source blobs exactly; README/header classes only preserve existing main styling. Confirmed canonical semantics and evidence boundaries. Official task-aware drift passes with all three adopted foreign documents unchanged; no unmerged files remain.
@@ -46,6 +50,7 @@
## Promotion Candidates
- 2026-09-26 产品定位由用户明确确认,已在 integration 模式直接写入规范产品文档;后续老师能力设计和验证以该定位为依据,无待确认的理念分歧。
- Accepted source candidates promoted in integration mode to the teacher ADR, system overview and current-state. No product direction, billing, version or file-permission conflict remains.
## Follow-up: Distributed Agent Titlebar