From 4b79e6784dee14374d0c8d037489deaa8bc2eabf Mon Sep 17 00:00:00 2001 From: brother7 <7brother7@gmail.com> Date: Sat, 26 Sep 2026 15:30:05 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BB=A5=E9=A2=86=E5=9F=9F=E6=9D=B0?= =?UTF-8?q?=E5=87=BA=E4=BA=BA=E7=89=A9=E7=9A=84=E8=83=BD=E5=8A=9B=E5=AE=9A?= =?UTF-8?q?=E4=B9=89=E8=80=81=E5=B8=88=20Agent?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .project-docs/00-brief/project-positioning.md | 18 ++++++++++-------- .../ADR-2026-09-22-coding-teacher.md | 2 +- .project-docs/10-decisions/decision-index.md | 2 +- .project-docs/30-worklog/current-state.md | 2 +- ...260924-merge-agent-rendering-ml-4efb196c.md | 6 ++++-- README.md | 2 +- 6 files changed, 18 insertions(+), 14 deletions(-) diff --git a/.project-docs/00-brief/project-positioning.md b/.project-docs/00-brief/project-positioning.md index 7f5a9b3e..235dc3c2 100644 --- a/.project-docs/00-brief/project-positioning.md +++ b/.project-docs/00-brief/project-positioning.md @@ -32,25 +32,27 @@ A good solution should {quality bar}. 用户确认日期：2026-09-26。 -老师 Agent 将在某些领域具有特殊能力的人的专业经验与判断方法进行总结、提炼和蒸馏，形成可下发给平台学生用户的智能体，为学生在这些领域遇到的真实问题提供判断能力。 +老师 Agent 是某一领域杰出人物的能力转化而成的智能体，供平台学生用户使用。 -### 能力来源与蒸馏内容 +产品定义的重点是承载谁在什么领域的哪些能力，以及这些能力能为学生提供什么价值。蒸馏属于能力转化的一种实现方法。 -能力来源于在特定领域有独特能力、成熟经验和判断方法的人。每位老师 Agent 应明确能力来源、擅长的领域以及适用边界。 +### 能力来源与内涵 -蒸馏重点包括：如何定义和观察问题、关注哪些证据、采用什么判断标准、如何权衡取舍，以及哪些新事实会使其改变判断。提示词、Skill、案例和知识共同承载这些方法；名称、头像与表达风格用于呈现身份，能力建设以领域判断质量为核心。 +能力来源于在特定领域具有杰出能力的人。每位老师 Agent 应明确能力来源、擅长的领域、所承载的能力及其适用边界。 + +这些能力包括对领域问题的理解、专业经验、观察方式、判断标准、取舍方法和解决问题的能力。在具体问题中，学生应能获得这些能力带来的帮助，例如识别关键问题、理解判断依据、比较可行方向，以及根据新事实调整判断。 ### 提供给学生的价值 -学生带着项目、作品或困惑使用老师 Agent，获得具体的领域判断、判断依据及可考虑的下一步，并逐步理解这些判断方法。不同老师可以提供不同领域的观察角度与专长，学生保留自己的选择和决定权。 +学生带着项目、作品或困惑使用老师 Agent，获得领域杰出人物的能力支持，包括具体的专业判断、判断依据及可考虑的下一步，并逐步理解其思考和解决问题的方法。不同老师提供不同领域的能力与专长，学生保留自己的选择和决定权。 例如，游戏设计领域可以判断玩法是否成立、反馈是否清晰；创作领域可以判断表达是否准确、作品特点是否形成。这些是能力方向示例，具体智能体的适用范围需由其能力定义和案例验证确定。 -### 能力建设与验证 +### 实现方式与能力验证 -建设路径：发现有特殊能力的人 → 提炼其判断方法 → 用真实案例验证 → 形成老师 Agent → 下发给学生使用。 +能力总结、提炼和蒸馏，以及提示词、Skill、案例与知识，属于把人的领域能力转化为 Agent 能力的实现方式和载体。具体实现服务于上述定义，名称、头像与表达风格用于呈现身份。 -能力验证关注学生面对新的真实问题时，智能体能否给出有辨识度、有依据、有帮助的领域判断，说明取舍与适用条件，并在信息不足时明确判断的限制。这是后续能力建设和验收标准；本次定位确认不表示现有所有下发智能体已经完成此类验证。 +能力验证关注学生面对新的真实问题时，智能体是否体现所承载的领域能力：能否给出有辨识度、有依据、有帮助的判断与解决思路，说明取舍和适用条件，并在信息不足时明确能力与判断的限制。这是后续能力建设和验收标准；本次定义确认不表示现有所有下发智能体已经完成此类验证。 ### 产品定位与交付机制 diff --git a/.project-docs/10-decisions/ADR-2026-09-22-coding-teacher.md b/.project-docs/10-decisions/ADR-2026-09-22-coding-teacher.md index 5bb855ea..2552d6a1 100644 --- a/.project-docs/10-decisions/ADR-2026-09-22-coding-teacher.md +++ b/.project-docs/10-decisions/ADR-2026-09-22-coding-teacher.md @@ -6,7 +6,7 @@ ## Product Positioning -2026-09-26 用户明确确认：老师 Agent 的产品核心是将特定领域中有特殊能力的人的判断能力提炼、蒸馏后，下发给平台学生，为真实问题提供领域判断。能力来源、蒸馏内容、学生价值与真实案例验证标准集中记录在[产品定位](../00-brief/project-positioning.md#老师-agent-的产品定位)。下列云端执行、上下文读取与咨询交互决定服务于这一能力交付；客户端统一智能体模型保持。 +2026-09-26 用户明确确认并进一步澄清：老师 Agent 是某一领域杰出人物的能力转化而成的智能体，供平台学生使用。定义以人的领域能力及学生价值为中心，蒸馏属于实现方法。能力来源、能力内涵、学生价值与真实案例验证标准集中记录在[产品定位](../00-brief/project-positioning.md#老师-agent-的产品定位)。下列云端执行、上下文读取与咨询交互决定服务于这一能力交付；客户端统一智能体模型保持。 ## Decision diff --git a/.project-docs/10-decisions/decision-index.md b/.project-docs/10-decisions/decision-index.md index 61998e66..5110af0d 100644 --- a/.project-docs/10-decisions/decision-index.md +++ b/.project-docs/10-decisions/decision-index.md @@ -1,6 +1,6 @@ # Decision Index -- 2026-09-26 已确认[老师 Agent 产品定位](../00-brief/project-positioning.md#老师-agent-的产品定位)：蒸馏特定领域优秀人才的判断能力，下发给平台学生，并以真实案例验证领域判断质量；补充下方既有咨询技术决定。 +- 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 字节。 diff --git a/.project-docs/30-worklog/current-state.md b/.project-docs/30-worklog/current-state.md index 04d094e9..bac9e977 100644 --- a/.project-docs/30-worklog/current-state.md +++ b/.project-docs/30-worklog/current-state.md @@ -4,7 +4,7 @@ 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-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)；安装版/生产模型仍待验收。 diff --git a/.project-docs/30-worklog/tasks/20260924-merge-agent-rendering-ml-4efb196c.md b/.project-docs/30-worklog/tasks/20260924-merge-agent-rendering-ml-4efb196c.md index 393b896f..5179456a 100644 --- a/.project-docs/30-worklog/tasks/20260924-merge-agent-rendering-ml-4efb196c.md +++ b/.project-docs/30-worklog/tasks/20260924-merge-agent-rendering-ml-4efb196c.md @@ -12,12 +12,13 @@ ## Scope -- 产品定位后续（2026-09-26）：依据用户明确纠正并确认的理念，在 Makelore 产品定位、老师 ADR 和 README 记录“蒸馏有特殊领域能力的人的判断能力，形成老师 Agent，下发给平台学生使用”。这是既有智能体工作的产品定义澄清，仅更新文档。 +- 产品定位后续（2026-09-26）：依据用户确认及进一步澄清，在 Makelore 产品文档记录“老师 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 +- 用户进一步明确重点是老师 Agent 的定义“某领域杰出的人的能力变成一个 agent”。官方同任务续接核验与 Concurrent/Planning/Integration Gates 再次通过，重读本轮六份产品记录，复用未变的 116 个 peer 范围。计划：统一定义、能力内涵、学生价值和方法层次；核对文档差异、边界门禁后提交，不把蒸馏流程作为产品核心，也不收窄为单一聊天或判断技巧。 - 定位记录的 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. @@ -27,7 +28,7 @@ ## Outcome -- 产品定位后续（2026-09-26）：用户确认的老师 Agent 理念已集中写入 project-positioning，并由 README、老师 ADR、决定索引和 current-state 引用。核心是将有特殊领域能力的人的判断方法蒸馏并交付给学生；明确能力来源、蒸馏内容、学生价值、建设路径与真实案例验证标准。既有交互和云端能力边界保持，未修改任何运行代码或线上定义。 +- 产品定位后续（2026-09-26）：按用户进一步澄清，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. @@ -35,6 +36,7 @@ ## Verification +- 定义澄清后再次检查六份文档差异，git diff --check 和官方文档门禁通过。原链接路径与标题锚点保持，3 份 adopted 外来文档未变。纯文字修订未运行应用测试或构建。 - 定位记录：检查六个文档的差异与新增链接/标题目标，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. diff --git a/README.md b/README.md index 48a918ee..19ddbe29 100644 --- a/README.md +++ b/README.md @@ -159,7 +159,7 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p ### 下发智能体咨询 -老师 Agent 的产品定位是将特定领域中有特殊能力的人的专业经验与判断方法提炼、蒸馏成智能体，下发给平台学生，在真实项目、作品和问题中提供领域判断。能力建设聚焦观察方法、证据选择、判断标准、取舍与适用边界，并通过真实案例验证；云端下发、上下文读取和聊天是能力交付方式。完整理念见[老师 Agent 产品定位](.project-docs/00-brief/project-positioning.md#老师-agent-的产品定位)。 +老师 Agent 是某一领域杰出人物的能力转化而成的智能体，供平台学生使用，在真实项目、作品和问题中提供专业理解、判断与解决问题的能力支持。定义以人的领域能力及学生价值为中心；蒸馏属于实现方法，云端下发、上下文读取和聊天是能力交付方式。完整理念见[老师 Agent 产品定位](.project-docs/00-brief/project-positioning.md#老师-agent-的产品定位)。 - 新话题可选择运营下发的 Yuxi 智能体，默认使用指定智能体；提示词、Skills、知识库和模型配置由 Yuxi 管理，运营同步后生成新版本，已有话题固定原版本。Yuxi 智能体模型费用由当前学生的编程词元点数支付，个人 Agents 模块仍由创建者付费；不要求学生开通个人云智能体模块。停用的智能体仍可查看历史，不能借另一位智能体的可用状态继续提问。 - Main 为智能体每轮请求绑定当前账号、项目和所选操作会话，提供 `list_project_files`、`read_project_file`、`read_conversation` 三个只读工具。云端通过持久中断请求整批读取，Main 返回配对结果并续接同一问题；若原运行仍在释放资源，保留同一批读取结果等待续接，等待期间仍支持取消并受原问题时限约束。本地旧版智能体也支持相同读取边界。可读当前项目源码及 `.makelore/project.json`，拒绝其他 `.makelore` 历史、Git 内部数据和越界路径；不提供写文件或命令执行。这些能力不按名称或人设区分。