docs(agents): 炼境根定位收敛为 agent 开发子项目的管家

- 项目定位改为管家:摩擦驱动沉淀跨 agent 结构化能力
- 新增「管家准入与退出」:五条准入、不做、分发 vs 查询、退出规则
- project-brief 定位同步,指向 AGENTS.md 单一来源

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
lanrtop 2026-09-30 11:34:11 +09:00
parent feb030431e
commit 1f316c0abb
2 changed files with 16 additions and 3 deletions

View File

@ -4,8 +4,9 @@
## 项目定位 ## 项目定位
Git 多空间开发管理器,同时也是**项目 Agent 化的本地控制面**。 **炼境是 agent 开发子项目的管家**:agent(Claude、Codex、DeepSeek 等)在哪里反复摩擦,管家就把那项能力沉淀并结构化为跨 agent 可调用的通用能力,让 agent 拿到任务即能开工、能自验、能交付。
以蓝图为神经系统,为 Codex、Claude 等可替换客户端 adapter 分发基线、发现状态并采集交付信号;项目自身保留业务规则、测试、部署声明与交付决策。 分工:agent 负责推理、编码、模型与子 Agent 调度;炼境负责项目身份、环境就绪、验证资源、任务上下文与证据采集;子项目保留业务规则、spec、测试、部署链路与生产凭证,离开炼境仍可独立开发。
成长方式是摩擦驱动闭环:摩擦信号(envoy 回传、复盘、人工解围、返工)→ 准入筛选 → 结构化为 MCP 工具 / 能力包 / 分发基线 → 在成熟子项目实测收益 → 保留、调整或撤销。准入与边界见下方「管家准入与退出」。
炼境本身亦被纳入其中,形成可自我进化的开发智能闭环。 炼境本身亦被纳入其中,形成可自我进化的开发智能闭环。
## 技术栈 ## 技术栈
@ -298,6 +299,18 @@ docs/templates/ 炼境接入包模板草案(设计层)
注意 master 直推场景 CI 是**事后红灯**(提交已落库,红灯提醒修复),仅 PR 流程构成事前拦截—— 注意 master 直推场景 CI 是**事后红灯**(提交已落库,红灯提醒修复),仅 PR 流程构成事前拦截——
这是与「S 级直推 master」约定的有意权衡,勿以「加分支保护禁直推」名义收紧。 这是与「S 级直推 master」约定的有意权衡,勿以「加分支保护禁直推」名义收紧。
### 管家准入与退出(2026-09-30 用户立法)
- **准入**:新能力须同时满足五条才沉淀进炼境——通用(多个子项目会遇到)、可结构化(能成为
schema / MCP 工具,agent 可查询可断言)、跨 agent(同一入口,不绑某家客户端)、与 agent 原生能力
互补(不与其调度、子 Agent、模型选择竞争)、消除重复(每个项目/会话都要重做的配置或摸索)。
- **不做**:不替 agent 思考或选模型;不替 agent 判定完成;不接管子项目自有事实;不让子项目依赖炼境在线。
- **分发 vs 查询**:需随分支走、离线必读、客户端启动即读的稳定基线才写进子项目(版本化能力包 +
托管块,先预览再单项目 apply);易变、跨项目、含敏感、可重建的内容一律走 MCP 按需查询,分发最多写能力声明,不写值。
- **退出**:实测无收益、被 agent 原生能力覆盖、或维护成本超过收益的能力要撤销,不因「已经做了」而保留。
- **为什么**:管家的价值是给 agent 减负,一旦越权或膨胀,就会变成新的摩擦来源;能力是否留下要看实测数据,
验证场优先用最成熟的子项目 enterprise-system。
### 炼境自己的 Agent 按钮清单 ### 炼境自己的 Agent 按钮清单
| 能力 | 调用方式 | 通过标准 | | 能力 | 调用方式 | 通过标准 |

View File

@ -1,6 +1,6 @@
# 炼境 — 速查卡 # 炼境 — 速查卡
**定位**:项目 Agent 化的本地控制面。炼境管理多个 Git 工作区,分发版本化基线、发现状态并汇总交付信号;项目本身仍拥有业务规则、测试、部署声明与交付决策。 **定位**:agent 开发子项目的管家。agent 反复摩擦之处,炼境沉淀为跨 agent 可调用的结构化能力(分发版本化基线、提供项目身份/环境/验证资源/任务上下文、汇总交付信号);项目本身仍拥有业务规则、测试、部署声明与交付决策。准入/退出规则见 AGENTS.md「管家准入与退出」。
## 技术栈 ## 技术栈