mirror of https://git.openapi.site/https://github.com/desirecore/market.git synced 2026-06-06 05:50:41 +08:00

Files

yi-ge 8047c8b0dc fix: 修复 desirecore PR #533 Copilot 评审反馈的 7 项内容问题

[desirecore PR #533](https://github.com/desirecore/desirecore/pull/533) 把
market 全局技能快照同步到主仓库，Copilot 自动评审命中 7 处文档与代码
不一致问题，全部根因在 market 的 skill 文档；本 PR 在源头修复，让下次
sync-global-skills 自然带过去。

修复内容：

1. disable-model-invocation 语义描述反向（3 处文件 × 2 语言 = 5 处编辑）
   - skill-creator/SKILL.md (en-US)
   - skill-creator/SKILL.zh-CN.md
   - manage-skills/SKILL.md (en-US)
   - manage-skills/SKILL.zh-CN.md
   - 注：references/desirecore-format.md 已在 PR #1 解冲突时一并修好

   实际代码逻辑（lib/agent-service/skills/parser.ts）：只有显式
   `disable-model-invocation: false` 才会被加入 system prompt 自动加载列表，
   `true` 或缺省都会跳过自动注入、需显式 Skill 工具调用。文档原描述把这两个
   值的语义对调了，且错误地宣称存在 L0/L1 vs L0+L1+L2 的"分层加载机制"
   （runtime 不区分这三个层级，加载就是整篇 SKILL.md）。

2. dev-environment-setup/references/probe-snapshot.md 协议字段类型 / 超时承诺
   - desirecore_port_file: string → boolean（probe.sh 输出 ${PORT_FILE_EXISTS}
     原生 bool；probe.ps1 输出 PowerShell bool；JSON 序列化均为 true/false）
   - "CLI 调用最长 5s" → "CLI 调用依赖工具自身实现，无显式 timeout 包装，
     正常情况通常 <5s 完成"（HTTP probe 确有 0.5s/1s timeout，但 --version
     这类 CLI 没有 timeout 5s 包装，文档原文承诺超出实现）

3. minimax-music-gen 使用过时的 provider 字段（应为 providerId）
   - skills/minimax-music-gen/SKILL.md（3 处）
   - skills/minimax-music-gen/SKILL.zh-CN.md（3 处）
   - 与 sibling minimax-tts/image-gen/video-gen 对齐，使用
     `"providerId": "provider-minimax-media-001"`，避免 media-proxy 路由到
     coding/token plan 等同名 provider

版本与日期：

- skill-creator: 1.0.1 → 1.0.2
- manage-skills: 1.0.2 → 1.0.3
- dev-environment-setup: 2.0.1 → 2.0.2
- minimax-music-gen: 1.1.1 → 1.1.2
- 上述 4 个 SKILL.md 的 metadata.updated_at 与 manifest.json#stats.lastUpdated
  统一为 2026-05-05

i18n 处理：

按 PR #1 修复模式（commit 2a21e8e），同步编辑英文源（SKILL.md = en-US default）
与中文翻译（SKILL.zh-CN.md = source），不动 metadata.i18n.<locale>.source_hash /
translated_at 字段（CI translate.py 维护）。

2026-05-05 00:47:30 +08:00

9.7 KiB

Raw Blame History

name, description, version, type, risk_level, status, disable-model-invocation, tags, metadata, market

name

description

version

type

risk_level

status

disable-model-invocation

tags

metadata

market

dev-environment-setup

Use this skill as a router/index when the user faces a development environment question that spans multiple domains: containers (Docker/Podman), WSL2 on Windows, office-skill dependencies (DOCX/PDF/XLSX/ PPTX), or system tools (LibreOffice/Poppler/Pandoc/Tesseract). For pure Python issues use python-runtime skill; for pure Node.js issues use nodejs-runtime skill. Triggers include: "setup environment", "PATH", "WSL", "WSL2", "docker not found", "podman", "container", "office dependency", "LibreOffice", "poppler", "pandoc", "tesseract", or any cross-cutting environment question. 使用场景：用户提到环境配置、PATH、容器、Docker、Podman、WSL、WSL2、办公依赖、系统工具，或不确定属于 Python / Node.js 时的入口指引。

2.0.2

procedural

low

enabled

true

environment

docker

container

wsl

office

system-tools

router

author

updated_at

i18n

desirecore

2026-05-05

default_locale

source_locale

locales

zh-CN

en-US

zh-CN

en-US

name	short_desc	description	body	source_hash	translated_by
开发环境综合配置	开发环境综合入口（容器 / WSL / 办公依赖 / 系统工具）	Use this skill as a router/index when the user faces a development environment question that spans multiple domains: containers (Docker/Podman), WSL2 on Windows, office-skill dependencies (DOCX/PDF/XLSX/ PPTX), or system tools (LibreOffice/Poppler/Pandoc/Tesseract). For pure Python issues use python-runtime skill; for pure Node.js issues use nodejs-runtime skill. Triggers include: "setup environment", "PATH", "WSL", "WSL2", "docker not found", "podman", "container", "office dependency", "LibreOffice", "poppler", "pandoc", "tesseract", or any cross-cutting environment question. 使用场景：用户提到环境配置、PATH、容器、Docker、Podman、WSL、WSL2、办公依赖、系统工具，或不确定属于 Python / Node.js 时的入口指引。	./SKILL.zh-CN.md	sha256:7e4baaf42d5c0ace	human

name	short_desc	description	body	source_hash	translated_by	translated_at
Dev Environment Setup	Unified dev environment entry (container / WSL / office deps / system tools)	Use this skill as a router/index when the user faces a development environment question that spans multiple domains: containers (Docker/Podman), WSL2 on Windows, office-skill dependencies (DOCX/PDF/XLSX/ PPTX), or system tools (LibreOffice/Poppler/Pandoc/Tesseract). For pure Python issues use python-runtime skill; for pure Node.js issues use nodejs-runtime skill. Triggers include: "setup environment", "PATH", "WSL", "WSL2", "docker not found", "podman", "container", "office dependency", "LibreOffice", "poppler", "pandoc", "tesseract", or any cross-cutting environment question. Use when the user mentions environment setup, PATH, containers, Docker, Podman, WSL, WSL2, office dependencies, system tools, or needs an entry-point guide when uncertain whether the issue belongs to Python or Node.js.	./SKILL.md	sha256:7e4baaf42d5c0ace	ai:claude-opus-4-7	2026-05-03

icon

dev-environment-setup Skill (v2.0.0 router)

L0: One-line Summary

When to use: The user needs to

Install / troubleshoot Docker or Podman containers ("docker not found", daemon startup, registry mirror, etc.)
Configure WSL2 (Linux Subsystem) on Windows
One-shot install of office skill dependencies (Python packages + npm packages + system tools required by DOCX / PDF / XLSX / PPTX)
Install system tools: LibreOffice / Poppler / Pandoc / Tesseract / qpdf / ImageMagick / Ghostscript / Git
Uncertain whether the issue belongs to Python or Node.js, and a comprehensive diagnosis is needed first

When not to use: Use python-runtime for pure Python issues, and nodejs-runtime for pure Node.js issues.

How to do it: First run scripts/probe.sh (use probe.ps1 on Windows) to obtain a system snapshot JSON, and route to the corresponding references or sub-skill based on the result; this skill is also the source of truth for DesireCore's built-in Hatch / Volta / HTTP API / Socket.IO integration (references/desirecore-runtime.md).

L1: Routing Rules

Route directly to the corresponding skill or document by the keywords in the user's question:

Keyword / Scenario	Path
python / pip / venv / pyenv / hatch / virtualenv / PEP 668	`python-runtime` skill
node / npm / pnpm / yarn / volta / nvm / fnm / EACCES	`nodejs-runtime` skill
docker / podman / container / container daemon	`references/container.md`
WSL / WSL2 / Windows Linux Subsystem	`references/wsl.md`
DOCX / PDF / XLSX / PPTX dependencies / office skill dependencies	`references/office-deps.md`
LibreOffice / poppler / pandoc / tesseract / qpdf	`references/system-tools.md`
Unsure of category, want a quick diagnosis	First run `scripts/probe.sh` and inspect the JSON
DesireCore Hatch / Volta / HTTP API / Socket.IO	`references/desirecore-runtime.md`
Four-tier fallback decision (API → CLI → package manager → community solution)	`references/decision-tree.md`

L2: Detailed Specification

Step 1: Quick Diagnosis

bash skills/dev-environment-setup/scripts/probe.sh > /tmp/env-probe.json
cat /tmp/env-probe.json | jq .

For the meaning of output fields, see references/probe-snapshot.md. On Windows use scripts/probe.ps1.

Step 2: Route by Result

desirecore_api non-empty → take the HTTP API path (references/desirecore-runtime.md)
tools.python3.available = false or tools.node.available = false → enter the corresponding sub-skill
tools.docker.available = false and the user needs containers → references/container.md
wsl.installed = false and Windows user → references/wsl.md

Step 3: Execute the Sub-skill Decision Tree

Both python-runtime and nodejs-runtime have their own four-tier fallback (L1 API → L2 built-in CLI → L3 system package manager → L4 community solution), defined in the shared references/decision-tree.md.

Step 4: Office Skill Dependencies

Quick lookup for the office quartet (DOCX / PDF / XLSX / PPTX) dependencies: references/office-deps.md. Includes one-shot install commands for Python packages, npm packages, and system tools.

Step 5: System Tools

Installation and troubleshooting for LibreOffice / Poppler / Pandoc / Tesseract / qpdf / ImageMagick / Ghostscript: references/system-tools.md.

DesireCore Built-in Environment Management Base

DesireCore embeds Hatch (Python) and Volta (Node.js), providing complete environment management via HTTP API + Socket.IO. This skill and the sub-skills (python/nodejs) all rely on:

Document	Content
`references/desirecore-runtime.md`	Binary path table, HTTP API quick-reference, Socket.IO event contracts, `EnvironmentSnapshot` data structure
`references/decision-tree.md`	Four-tier fallback flowchart, concrete signals for failure detection, switch prompts
`references/probe-snapshot.md`	Probe script JSON output protocol

Important Constraints

Do not write strong keywords like python / node / pip / npm into this skill's description—those belong to their respective sub-skills, to avoid trigger conflicts.
API first: scripts/probe.sh first checks ~/.desirecore/agent-service.port; if it exists, recommend the HTTP API path.
Cache coherence: after any install/uninstall completes, call POST /api/runtime/environment/refresh to invalidate the cache before issuing subsequent GETs.
Cross-platform: every command template provides both macOS / Linux and Windows (PowerShell) versions.

Sub-skill and Document Manifest

skills/
├── python-runtime/        # Python environment (Hatch first)
├── nodejs-runtime/        # Node.js environment (Volta first)
└── dev-environment-setup/         # This skill (composite entry)
    ├── references/
    │   ├── desirecore-runtime.md
    │   ├── decision-tree.md
    │   ├── probe-snapshot.md
    │   ├── container.md
    │   ├── wsl.md
    │   ├── office-deps.md
    │   └── system-tools.md
    └── scripts/
        ├── probe.sh
        └── probe.ps1

Upgrade Notes (v1.x → v2.0.0)

v1.x was a 1380-line all-in-one manual, now split.
Python-related → python-runtime
Node.js-related → nodejs-runtime
Docker / WSL / office dependencies / system tools → this skill's references/
DesireCore Hatch / Volta upgraded from "optional community solution" to mandatory L1/L2 primary path

Downstream skills (docx / pdf / xlsx / pptx) should rewrite "for Python environment issues, see dev-environment-setup" to "for Python environment issues, see python-runtime / for Node.js environment issues, see nodejs-runtime".

9.7 KiB Raw Blame History Unescape Escape