All checks were successful
Push & PR Check / check (push) Successful in 1m4s
- 同一模板同时写 .agents/skills(Codex、DSH)与 .claude/skills(Claude Code) - verify_onboarding 新增「Claude 炼境技能已分发」检查 - skill 降级步骤改为三端通用,提示无开发变量工具即连的是全局地址 - capability-packs supported_clients 增加 dsh Feature-Confirmed: true Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.7 KiB
3.7 KiB
| name | description |
|---|---|
| lian-jing | 读取炼境项目健康状态,并使用炼境 MCP 的项目管理、Gitea 与交付能力。 |
炼境项目技能
开始项目工作时,先读取根 AGENTS.md 与 .lian-jing/context.json 取得 project_id。.claude/liangjing.json 仅为旧项目的 Claude 兼容投影,不能作为长期身份来源。
如果当前客户端已发现 lian-jing MCP:
- scoped MCP 连接已由 URL 绑定当前
project_id,项目级调用可省略project_id;若 server initialize 明确报告 legacy,迁移前才显式传入 canonicalproject_id,绝不传其他项目 ID。 - 优先调用
get_diagnostics,将其作为当前项目健康状态的事实来源。 - 在 Node/pnpm 项目运行包管理命令前调用
get_toolchain_status(project_id);ready_managed时通过mise exec -- pnpm ...执行,其他状态先报告实际版本与 executable 证据。 - 只有用户明确确认本次下载安装后,才可调用
prepare_toolchain(project_id, confirmed=true);不得为适配客户端 bundled runtime 而修改项目版本或 lockfile。 - 交付、Gitea、CI、蓝图等平台状态优先通过 MCP 查询,不凭静态文档猜测。
- 合并 PR 前调用
get_delivery_status(project_id),向用户展示 PR 编号、完整 head SHA、CI 与 review。只有当前用户明确确认该 PR 与 SHA 后,才调用merge_pull_request(project_id, pr_number, expected_head_sha, confirmed=true);合并后再次读取交付状态。不得自行推断确认。 - 生成 CI workflow 时先调用
plan_cicd_workflow(project_id, workflow_type),向用户展示目标文件、变更类型、content_digest、工具链来源与所需 secret 名称;只有用户明确确认这份摘要后,才以同一 digest 调用apply_cicd_workflow(..., confirmed=true)。该流程只写项目 workflow,不配置 secret、不触发 CI 或部署;不得通过 MCP 传服务器地址、命令、路径或 secret 值,部署类配置先由用户在炼境 UI 保存。 - 需要测试账号或开发变量(登录自验、沙箱 key 等)时,先调用
list_project_dev_variables查找:已配置则用read_project_test_account/read_project_dev_variable单项读取;没有则用register_project_test_account登记名称、目标系统、非生产环境与用途,并请用户在炼境项目 UI「开发变量」中填写。不得在对话中向用户索要明文密码,不得登记生产账号,不得把读到的值写入受 Git 跟踪的文件。读取因缺少项目认证被拒时,如实报告并改用项目原有配置方式,不得绕过认证。若 lian-jing 工具中根本没有list_project_dev_variables,说明当前客户端连的是全局地址/mcp而非本项目地址,按下方configured一步处理。
如果 MCP 未出现,按以下顺序降级,不猜测状态:
configured:确认当前客户端的lian-jing指向http://127.0.0.1:<port>/mcp/projects/<canonical project_id>——Codex 看项目.codex/config.toml,Claude Code 看~/.claude.json中本项目的 local 条目(优先于 user 级全局条目),DSH 看~/.dsh/cordis.patch.yml。缺失或仍指向全局/mcp时通过炼境重新inject_mcp,手工同名 server 不覆盖。reachable:配置正确后检查 loopback 服务;连接拒绝表示炼境未运行,先启动正式安装版并保持托盘进程。reload:服务可达但当前会话看不到工具时,新建会话或重载客户端;不要反复改配置或复制凭证。- 仍不可用时,明确报告停在哪一层,继续完成不依赖 MCP 的本地工作;不得伪造诊断、项目 ID、凭证或远端状态。