Przejdź do treści
Biblioteka skilli
Programowanie · Integracja z narzędziem

cordis-plugin-development

/cordis-plugin-development

Projektuje, dodaje i diagnozuje wtyczki, funkcje i połączenia MCP w profilu Harness, w tym wtyczki wyłączone domyślnie i elementy widoczne w interfejsie webowym.

Repozytorium
Agentrans ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
29
Skrypty
2
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: templates/decoration/client.js, templates/decoration/index.js

Co robi i kiedy

Projektuje, dodaje i diagnozuje wtyczki, funkcje i połączenia MCP w profilu Harness, w tym wtyczki wyłączone domyślnie i elementy widoczne w interfejsie webowym.

Oryginalny opis (EN)

Use when designing, reviewing, adding, enabling, disabling, installing, configuring, or debugging a plugin, bundle, feature, page, panel, tool, or MCP connection in the current Harness profile, including a shipped plugin that is disabled by default, and for any visual object, decoration, or widget request that names no other destination, which means an installed UI plugin rendered in the Harness Web UI.

Jak działa

  1. Design or review
  2. Enable a shipped plugin
  3. Deliver a working plugin first
  4. Knowledge sources, in order
  5. Read next
Sekcje z nagłówków SKILL.md, w oryginale · 47 linii, 1 038 słów
Podgląd SKILL.md
---
name: cordis-plugin-development
description: Use when designing, reviewing, adding, enabling, disabling, installing, configuring, or debugging a plugin, bundle, feature, page, panel, tool, or MCP connection in the current Harness profile, including a shipped plugin that is disabled by default, and for any visual object, decoration, or widget request that names no other destination, which means an installed UI plugin rendered in the Harness Web UI.
---

# Persistent Harness plugins

For implementation, use ordinary workspace files to author a bundle, then `plugin_manager` with `action: install_bundle` and the absolute package directory as `target` to install it in the current profile. Changes affect every session in that profile and survive restart. Load `editing-cordis-compositions` for agent preset changes.

Do not write the profile's `package.json` or `cordis.patch.yml`, create packages under `$AGENTRANS_HOME`, or run pnpm in the profile directory: `install_bundle` performs those steps, and each hand-made write outside the workspace needs its own approval. Every `plugin_manager` action, including `list_plugins` and `list_bundles`, also needs approval without Full access, so call it only when its result decides the next step.

## Design or review

Read the applicable references below and inspect the proposed or existing plugin against current APIs. Report design choices or findings instead of following the installation workflow. Do not write files, install bundles, or change profile state unless the user requests implementation.

## Enable a shipped plugin

A shipped bundle can resolve a plugin row and leave it `disabled`. The row id and its reason are in the shipped patch, `packages/bundle/*/cordis.patch.yml` in a source checkout. Write a workspace bundle whose patch overrides that row with `disabled: false` and inserts the Host rows it depends on; a source checkout's `apps/cli/config/examples/<feature>/cordis.yml` lists them for opt-in features. Packages shipped with Agentrans resolve from the Agentrans installation, so the bundle declares no dependencies on them. Install it with `install_bundle`.

## Deliver a working plugin first

1. Resolve the requested result and destination. An unspecified visual destination is the current Harness Web UI; a standalone image or HTML file does not complete such a request. Choose reasonable visual details and implement a small first version; install it before visual refinement.
2. Discover only the APIs needed for that version: `cordis_inspect_list`, then targeted `cordis_inspect_query` calls. For UI, query Client `Slots.listSubTree` and the selected slot's registration options and props. For anything beyond a static decoration, such as tool policy, agent context, session-derived state, or Chat rows, read `references/practices.md` before choosing the extension point; for a user action in plugin UI, also read `references/user-actions.md`. Once the chosen slot and registration API are known, write the plugin.
3. Read and copy the matching template files into one workspace directory, or author the package, patch, and required Host/Client files there. Before installing, complete the display checklist in `references/host-plugin.md`: meaningful localized titles/descriptions, an original or licensed icon, and exported resources with distribution checks where applicable. This applies to Host-only and configuration-only bundles too; adapt template text and artwork to the request. Check JavaScript syntax and the manifest, then install. Use the installed plugin as the first preview; do not create preview HTML, mock shells, design variants, screenshot scripts, or rasterizer tooling first.
4. Read the installation result: `application` and `warnings` decide whether the change is live, not logs, process lists, or the page's boot payload. Confirm new rows with approval-free `cordis_inspect_query`, not `list_plugins`. After `application: applied`, exercise the capability or inspect the live Client registration. Verify installed display metadata and the icon using `references/host-plugin.md`. Use the connected page when available; follow `references/verification.md` for page/panel design checks and unavailable browser control, and `references/user-actions.md` for user actions. Restore user state changed during testing. Report verification limits; installation and slot registration alone do not establish what the user sees.
5. Fix observed defects in the same plugin. When the requested result works, finish with its location, verification status, and the reason for any display-resource exception; never silently accept default artwork. Do not continue speculative variants, optional features, or mock previews. Close any task list.

## Knowledge sources, in order

1. Inspection: `cordis_inspect_query` answers exact Service methods and Event modes (`Service`, `Event`), a mounted plugin's Config JSON Schema (`Config.listConfigs`: filter the paged directory by `name`, then query the `entry` id), the Tools this Agent can call (`Tool`), and live Client Slots and theme tokens (`Slots`, `Theme`).
2. Package documentation: `Config.listConfigs` with `name` set to the package finds its entries; querying one `entry` returns its `packageDir`, the resolved package directory. Read `<packageDir>/README.md`. Bundled packages resolve from the Agentrans installation and profile-installed bundles from the profile, so never guess the path from `$AGENTRANS_PROFILE_DIR`.
3. Source: installed packages ship built `lib/index.js` and `lib/types/**/*.d.ts` with JSDoc under that same `packageDir`, not `src/`; a source checkout of DSH has `packages/<group>/<name>/src`. Read them when inspection and the README leave a question open, and start source-level diagnosis from a concrete installation or runtime failure.

`AGENTRANS_PROFILE` (profile name) and `AGENTRANS_PROFILE_DIR` (its directory, whose `node_modules` holds only profile-installed bundles) are set in every shell call of a profile-launched Harness and absent when the Harness was booted without a profile. Bash reads them as `$AGENTRANS_PROFILE`; PowerShell, which the Windows preset uses, reads them as `$env:AGENTRANS_PROFILE`. With `agentrans` on the PATH, `agentrans --profile "$AGENTRANS_PROFILE" --dump-config` prints the composed profile.

## Read next

The files below live in this skill's base directory, which the `skill` tool reported, and the table is the complete list: do not enumerate that directory. In every deployment, including a source checkout, read these files with the file-read tool, write copies into the workspace with the file-write tool, and verify a copy by reading it back. In Desktop the directory sits inside `app.asar`, which only the Host process's own file reads can open; shell commands (`ls`, `cat`, `cp`, `cmp`), the glob and search tools (they run a native ripgrep process), `node`, and pnpm all fail on it. Never install or syntax-check a template in place; copy its contents into the workspace first.

| Task | File |
|---|---|
| Bundle manifest, locale resources, icons, installation, Host exports and Config | `references/host-plugin.md` |
| Web UI: Client manifest, module loader, slot registration | `references/ui-plugin.md` |
| Connecting an MCP server through a configuration-only bundle | `references/mcp-bundle.md` |
| Page/panel design checks and verification without browser control | `references/verification.md` |
| UI plugin template, including display resources | `templates/decoration/package.json`, `templates/decoration/cordis.patch.yml`, `templates/decoration/index.js`, `templates/decoration/client.js`, `templates/decoration/locale`, `templates/decoration/icon.svg` |
| MCP bundle template, including display resources | `templates/mcp/package.json`, `templates/mcp/cordis.patch.yml`, `templates/mcp/locale`, `templates/mcp/icon.svg` |
| Loader patch dialect and the list of installable plugin packages | the `cordis-composition-reference` skill |
| Choosing extension points, contexts, and state mechanisms for upgrade stability and performance | `references/practices.md` |
| Sharing application operations between UI actions and agent tools | `references/user-actions.md` |
Pliki w paczce (29)
  • SKILL.md 8 KB
  • references/host-plugin.md 7 KB
  • references/mcp-bundle.md 1 KB
  • references/practices.md 8 KB
  • references/ui-plugin.md 2 KB
  • references/user-actions.md 1 KB
  • references/verification.md 1 KB
  • templates/decoration/client.js 1 KB
  • templates/decoration/cordis.patch.yml 1 KB
  • templates/decoration/icon.svg 1 KB
  • templates/decoration/index.js 1 KB
  • templates/decoration/package.json 1 KB
  • templates/decoration/locale/de.json 1 KB
  • templates/decoration/locale/en.json 1 KB
  • templates/decoration/locale/es.json 1 KB
  • templates/decoration/locale/fr.json 1 KB
  • templates/decoration/locale/ja.json 1 KB
  • templates/decoration/locale/pt.json 1 KB
  • templates/decoration/locale/ru.json 1 KB
  • templates/mcp/cordis.patch.yml 1 KB
  • templates/mcp/icon.svg 1 KB
  • templates/mcp/package.json 1 KB
  • templates/mcp/locale/de.json 1 KB
  • templates/mcp/locale/en.json 1 KB
  • templates/mcp/locale/es.json 1 KB
  • templates/mcp/locale/fr.json 1 KB
  • templates/mcp/locale/ja.json 1 KB
  • templates/mcp/locale/pt.json 1 KB
  • templates/mcp/locale/ru.json 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · TLBtianhu/Agentrans100MIT
endtoend-ai/deepseek-harness-desktop-plus100MIT
deepseek-ai/deepseek-harness100MIT
admin1316/ark100MIT

Migawka bazy z 13.11.2026 · wersja paczki 1879a9c296a3 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100plugin-creator
    Pomaga dodać wtyczkę lub paczkę Cordis do projektu nakładki DSH i diagnozuje, czemu nowy wiersz nie aktywuje się.
  • 100dsh-plugin-engineering
    Buduje, zmienia i naprawia wtyczki DeepSeek Harness: narzędzia, usługi, zdarzenia, konfigurację, adaptery LLM i interfejs klienta.
  • 100dsh-npm
    Pakuje serwer MCP lub wtyczkę agenta jako pakiet Cordis dla DeepSeek Harness i publikuje go w registry.npmjs.org, aby dało się go zainstalować po nazwie pakietu.
  • 90cordis-composition-reference
    Opisuje dialekt YAML loadera Cordis i listę pakietów pluginów harnessu, używanych przy pisaniu łat i presetów agenta.
  • 90dsh-plugin-dev
    Podaje konwencje i pułapki budowania, instalowania, testowania i wydawania wtyczek DeepSeek Harness, także przy konfiguracji i projektowaniu parametrów.
  • 90dsh-doc
    Dostarcza fakty o działaniu DeepSeek Harness, np. o funkcjach, ustawieniach, wtyczkach i narzędziach, a także pomaga przy pakietach i MCP.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.