diff --git a/.blueprint/modules/agent-client-capability-packs.md b/.blueprint/modules/agent-client-capability-packs.md index 1bbc52e..b543e76 100644 --- a/.blueprint/modules/agent-client-capability-packs.md +++ b/.blueprint/modules/agent-client-capability-packs.md @@ -41,8 +41,8 @@ Codex 用户级插件 - 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: todo +### 🔵 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 diff --git a/plugins/README.md b/plugins/README.md new file mode 100644 index 0000000..5e41a1e --- /dev/null +++ b/plugins/README.md @@ -0,0 +1,5 @@ +# 炼境 Codex 插件源 + +`lian-jing-codex` 是 Skill-only 插件源码。它只指导 Codex 使用项目内已存在的炼境上下文与 MCP,不打包 MCP server、凭证、项目 ID 或部署能力。 + +项目身份始终来自 `.lian-jing/context.json`;Codex 的项目 UI、用户级插件安装和客户端全局配置都不是项目身份来源。 diff --git a/plugins/lian-jing-codex/.codex-plugin/plugin.json b/plugins/lian-jing-codex/.codex-plugin/plugin.json new file mode 100644 index 0000000..edac06d --- /dev/null +++ b/plugins/lian-jing-codex/.codex-plugin/plugin.json @@ -0,0 +1,18 @@ +{ + "name": "lian-jing-codex", + "version": "0.1.0", + "description": "Guide Codex through Lian Jing project context and existing MCP workflows.", + "author": { + "name": "Lian Jing" + }, + "skills": "./skills/", + "interface": { + "displayName": "炼境 · Codex", + "shortDescription": "在已接入项目中使用炼境工作流。", + "longDescription": "为 Codex 提供炼境项目上下文与既有 MCP 工作流指引;不携带凭证、项目身份或 MCP 配置。", + "developerName": "Lian Jing", + "category": "Productivity", + "capabilities": [], + "defaultPrompt": "检查当前项目的炼境接入状态,并在可用时使用已有 MCP 获取交付信号。" + } +} diff --git a/plugins/lian-jing-codex/skills/lian-jing/SKILL.md b/plugins/lian-jing-codex/skills/lian-jing/SKILL.md new file mode 100644 index 0000000..8347115 --- /dev/null +++ b/plugins/lian-jing-codex/skills/lian-jing/SKILL.md @@ -0,0 +1,16 @@ +--- +name: lian-jing-project +description: Inspect an already onboarded Lian Jing project, use its existing MCP tools for status, and preserve project-owned development decisions. Use when a Codex task needs Lian Jing onboarding or delivery context; do not use to configure credentials, deploy, or infer an unregistered project identity. +--- + +# 炼境项目上下文 + +在已接入炼境的项目中,需要读取接入状态、交付信号或提交分组建议时使用本 Skill。 + +1. 先读取项目根目录的 `AGENTS.md`、`.blueprint/` 规则和 `.lian-jing/context.json`。 +2. 仅将 `.lian-jing/context.json` 中的 `project_id` 用作炼境 MCP 调用参数。`.claude/liangjing.json` 只用于识别旧项目并提示迁移,不能作为长期身份来源。 +3. 当项目已有 `lian-jing` MCP 时,可调用 `get_diagnostics`、`verify_onboarding` 和 `get_delivery_status` 获取可观察信号;所有调用显式传入 `project_id`。 +4. 若缺少 canonical context、MCP 或项目登记,不得猜测 project_id、MCP URL、凭证或状态。说明缺失项,并建议通过炼境接入或 `inject_mcp` 修复。 +5. 炼境提供状态、凭证托管和受控入口;项目 Agent 仍负责代码判断、测试选择、提交分组与业务交付决策。不要把 CI 成功或部署信号表述为业务验收。 + +本插件不包含 MCP server、MCP URL、项目 ID、凭证、部署命令或客户端项目 UI 映射;这些都属于项目接入与炼境控制面。