57 lines
3.8 KiB
Markdown
57 lines
3.8 KiB
Markdown
---
|
||
id: agent-client-capability-packs
|
||
name: Agent 客户端能力包
|
||
status: planned
|
||
progress: 0
|
||
---
|
||
|
||
## 概述
|
||
|
||
炼境为项目提供稳定的本地控制面与信号；客户端能力包只负责将同一项目规则、MCP 与工作流投影给 Codex、Claude 等 Agent。项目根目录与 canonical context 是锚点，不能把任一客户端的项目 UI、插件安装状态或全局配置当作项目身份。
|
||
|
||
## 已确认边界
|
||
|
||
```
|
||
项目根目录
|
||
├── .lian-jing/context.json ← canonical project_id 与兼容版本
|
||
├── .codex/config.toml ← 项目级 Codex MCP 投影（P0 已有）
|
||
├── .claude/liangjing.json ← 历史兼容投影
|
||
└── .agents/skills/lian-jing/ ← 项目内工作流说明
|
||
|
||
Codex 用户级插件
|
||
└── Skill-only：指导读取项目状态并调用已存在的 MCP；不存 project_id、MCP URL、凭证或部署命令
|
||
```
|
||
|
||
不在本模块实现 IDE UI、客户端项目同步、staging、云部署或生产发布。手工定义的同名 MCP server 必须继续拒绝覆盖。
|
||
|
||
## 任务卡
|
||
|
||
### ✅ P2-A. 工具无关的 canonical 项目上下文与兼容迁移
|
||
- status: done
|
||
- complexity: M
|
||
- files: src-tauri/src/mcp_inject.rs, src-tauri/src/commands/onboarding.rs, src-tauri/src/mcp_tools.rs, docs/ai-context/project-context.yaml
|
||
- acceptance: "[cargo test] 对仅含 `.claude/liangjing.json` 的临时项目执行接入/验证 → 写入 `.lian-jing/context.json` 且 project_id 一致；已有 context 的未知字段保留；手工 `[mcp_servers.lian-jing]` 配置仍拒绝覆盖。"
|
||
- done_note: "2026-09-21：inject_mcp 先写 `.lian-jing/context.json`（schema_version=1、project_id），再写 Codex/Claude 投影；canonical 文件保留未知字段，旧 Claude context 继续保留运行时端口。"
|
||
|
||
### ✅ P2-B. 能力包描述符与 onboarding 自检报告
|
||
- status: done
|
||
- complexity: M
|
||
- depends: P2-A. 工具无关的 canonical 项目上下文与兼容迁移
|
||
- files: src-tauri/src/commands/onboarding.rs, src-tauri/src/mcp_tools.rs, src-tauri/resources/onboarding/, docs/ai-context/project-context.yaml
|
||
- acceptance: "[cargo test] verify_onboarding(project_id) → 对 canonical 缺失、legacy-only、pack 版本不符、Codex MCP 不可用分别返回可区分的 ready/missing/legacy/version_mismatch/unavailable 信号，且不将任一状态伪报为 ready。"
|
||
- done_note: "2026-09-21：新增 `.lian-jing/capability-packs.json` 基线描述符；verify_onboarding 对项目上下文、能力包、Codex skill/MCP 和既有基线逐项返回结构化状态与可执行升级提示。"
|
||
|
||
### 🔵 P2-C. Codex Skill-only 可移植能力包
|
||
- status: in_progress
|
||
- complexity: M
|
||
- depends: P2-B. 能力包描述符与 onboarding 自检报告
|
||
- files: plugins/lian-jing-codex/plugin.json, plugins/lian-jing-codex/.codex-plugin/plugin.json, plugins/lian-jing-codex/skills/lian-jing/SKILL.md, plugins/README.md
|
||
- acceptance: "[插件结构检查] manifest 与 skill 路径均在插件根目录内，skill 不含 project_id、127.0.0.1 MCP URL、凭证或部署命令；[新 Codex 会话] 已接入项目可按 skill 调用既有 MCP，未接入项目输出接入诊断而非虚构状态。"
|
||
|
||
### 📋 P2-D. 接入包版本、升级说明与架构防腐同步
|
||
- status: todo
|
||
- complexity: M
|
||
- depends: P2-B. 能力包描述符与 onboarding 自检报告, P2-C. Codex Skill-only 可移植能力包
|
||
- files: AGENTS.md, docs/ai-context/project-brief.md, docs/ai-context/project-context.yaml, docs/templates/agents-meta-rules.md, resources/onboarding/
|
||
- acceptance: "[cargo test] 接入包升级检查 → 旧 context/旧能力包给出明确 upgrade_hint 且不自动覆盖用户配置；[rg] 常驻架构文档将炼境描述为项目控制面、客户端描述为 adapter，且不把客户端插件表述为凭证或部署所有者。"
|