From 1f316c0abbc3ba6266526a8bcaf71ab11d4e6e48 Mon Sep 17 00:00:00 2001 From: lanrtop Date: Wed, 30 Sep 2026 11:34:11 +0900 Subject: [PATCH] =?UTF-8?q?docs(agents):=20=E7=82=BC=E5=A2=83=E6=A0=B9?= =?UTF-8?q?=E5=AE=9A=E4=BD=8D=E6=94=B6=E6=95=9B=E4=B8=BA=20agent=20?= =?UTF-8?q?=E5=BC=80=E5=8F=91=E5=AD=90=E9=A1=B9=E7=9B=AE=E7=9A=84=E7=AE=A1?= =?UTF-8?q?=E5=AE=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 项目定位改为管家：摩擦驱动沉淀跨 agent 结构化能力 - 新增「管家准入与退出」：五条准入、不做、分发 vs 查询、退出规则 - project-brief 定位同步，指向 AGENTS.md 单一来源 Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 17 +++++++++++++++-- docs/ai-context/project-brief.md | 2 +- 2 files changed, 16 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 0d76747..954e6a4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,8 +4,9 @@ ## 项目定位 -Git 多空间开发管理器，同时也是**项目 Agent 化的本地控制面**。 -以蓝图为神经系统，为 Codex、Claude 等可替换客户端 adapter 分发基线、发现状态并采集交付信号；项目自身保留业务规则、测试、部署声明与交付决策。 +**炼境是 agent 开发子项目的管家**：agent（Claude、Codex、DeepSeek 等）在哪里反复摩擦，管家就把那项能力沉淀并结构化为跨 agent 可调用的通用能力，让 agent 拿到任务即能开工、能自验、能交付。 +分工：agent 负责推理、编码、模型与子 Agent 调度；炼境负责项目身份、环境就绪、验证资源、任务上下文与证据采集；子项目保留业务规则、spec、测试、部署链路与生产凭证，离开炼境仍可独立开发。 +成长方式是摩擦驱动闭环：摩擦信号（envoy 回传、复盘、人工解围、返工）→ 准入筛选 → 结构化为 MCP 工具 / 能力包 / 分发基线 → 在成熟子项目实测收益 → 保留、调整或撤销。准入与边界见下方「管家准入与退出」。 炼境本身亦被纳入其中，形成可自我进化的开发智能闭环。 ## 技术栈 @@ -298,6 +299,18 @@ docs/templates/ 炼境接入包模板草案（设计层） 注意 master 直推场景 CI 是**事后红灯**（提交已落库，红灯提醒修复），仅 PR 流程构成事前拦截—— 这是与「S 级直推 master」约定的有意权衡，勿以「加分支保护禁直推」名义收紧。 +### 管家准入与退出（2026-09-30 用户立法） + +- **准入**：新能力须同时满足五条才沉淀进炼境——通用（多个子项目会遇到）、可结构化（能成为 + schema / MCP 工具，agent 可查询可断言）、跨 agent（同一入口，不绑某家客户端）、与 agent 原生能力 + 互补（不与其调度、子 Agent、模型选择竞争）、消除重复（每个项目/会话都要重做的配置或摸索）。 +- **不做**：不替 agent 思考或选模型；不替 agent 判定完成；不接管子项目自有事实；不让子项目依赖炼境在线。 +- **分发 vs 查询**：需随分支走、离线必读、客户端启动即读的稳定基线才写进子项目（版本化能力包 + + 托管块，先预览再单项目 apply）；易变、跨项目、含敏感、可重建的内容一律走 MCP 按需查询，分发最多写能力声明，不写值。 +- **退出**：实测无收益、被 agent 原生能力覆盖、或维护成本超过收益的能力要撤销，不因「已经做了」而保留。 +- **为什么**：管家的价值是给 agent 减负，一旦越权或膨胀，就会变成新的摩擦来源；能力是否留下要看实测数据， + 验证场优先用最成熟的子项目 enterprise-system。 + ### 炼境自己的 Agent 按钮清单 | 能力 | 调用方式 | 通过标准 | diff --git a/docs/ai-context/project-brief.md b/docs/ai-context/project-brief.md index a1c00c2..52a7d2f 100644 --- a/docs/ai-context/project-brief.md +++ b/docs/ai-context/project-brief.md @@ -1,6 +1,6 @@ # 炼境 — 速查卡 -**定位**：项目 Agent 化的本地控制面。炼境管理多个 Git 工作区，分发版本化基线、发现状态并汇总交付信号；项目本身仍拥有业务规则、测试、部署声明与交付决策。 +**定位**：agent 开发子项目的管家。agent 反复摩擦之处，炼境沉淀为跨 agent 可调用的结构化能力（分发版本化基线、提供项目身份/环境/验证资源/任务上下文、汇总交付信号）；项目本身仍拥有业务规则、测试、部署声明与交付决策。准入/退出规则见 AGENTS.md「管家准入与退出」。 ## 技术栈