Skip to content

feat(terraphim-skills-intro): add community skills - #13

Open
AlexMikhalev wants to merge 3 commits into
zai-org:mainfrom
AlexMikhalev:codex/add-terraphim-skills-intro
Open

AlexMikhalev wants to merge 3 commits into
zai-org:mainfrom
AlexMikhalev:codex/add-terraphim-skills-intro

Conversation

@AlexMikhalev

@AlexMikhalev AlexMikhalev commented Sep 16, 2026

Copy link
Copy Markdown

What / 改动内容

Adds Terraphim Skills Introduction v0.2.2 to the official ZCode marketplace. The plugin gives agents three local-first Community skills for bounded code/document search, explicit operational learning capture, and role-scoped memory retrieval with provenance.

User-visible behavior

  • Installs exactly terraphim-grep, terraphim-agent-learn, and terraphim-agent-memory.
  • Documents Homebrew and signed-release dependency installation without automatic software installation.
  • Defaults search to local/read-only operation; learning and memory writes require an explicit user request.
  • Links neutrally to the Terraphim catalogue without checkout, transaction initiation, or bundled proprietary content.

Validation

  • python3 scripts/validate.py: 22 plugins accepted.
  • python3 scripts/build_dist.py: passed; Terraphim ZIP SHA-256 c96cd194e7bb1d1c56c0453b357fb1e33f295cd4b017f773e2f4d197d6ba0f92.
  • ZIP integrity and 14-member inventory passed, including LICENSE and NOTICE.
  • Installed Terraphim Clients v1.21.14 confirms every documented command and flag.
  • Source skill files, signatures, and hashes match the immutable, SSH-signed public v0.2.2 release.
  • Independent structured review: 5/5, no remaining P0/P1/P2 findings.
  • Real ZCode GUI installation is transparently outstanding because the validation Mac is locked; the official validator, deterministic build, package inventory, command compatibility, and embedded ZCode CLI checks have completed.

Dependencies, permissions, and side effects

  • Runtime binaries: terraphim-grep and terraphim-agent, installed separately by the user.
  • Search reads only selected local paths.
  • Learning/memory may write only to the user's configured local Terraphim store after an explicit request.
  • Optional model synthesis is disabled by default; if requested, it may use the user's configured provider and incur provider charges.
  • No bundled credentials, executables, hooks, background tasks, private endpoints, or telemetry.

Licence and provenance

Apache-2.0. Canonical LICENSE and NOTICE from the signed v0.2.2 source are bundled in the installable artifact. Source: https://github.com/terraphim/terraphim-cursor-plugin/tree/v0.2.2

Self-check / 自查清单

  • Plugin name is unique kebab-case; directory is plugins/terraphim-skills-intro/
  • version is identical in plugin.json and marketplace.json
  • README.md and README_CN.md are equivalent
  • description_i18n includes en and zh-CN
  • No secrets, machine-specific paths, or private dependencies
  • Model/API/network dependencies and side effects are documented
  • validate.py, build_dist.py, and git diff --check pass

@AlexMikhalev

Copy link
Copy Markdown
Author

Additional real-host validation completed against the public terraphim/terraphim-cursor-plugin v0.2.2 repository using ZCode 0.15.2 in an isolated storage profile:

  • plugins/marketplace/add added the public GitHub repository with no diagnostics.
  • plugins/overview discovered terraphim-skills-intro v0.2.2.
  • plugins/install installed it enabled at user scope with no diagnostics.
  • plugins/validate returned ok: true with no diagnostics.
  • plugins/describe returned exactly the three intended skills: terraphim-grep, terraphim-agent-learn, and terraphim-agent-memory.

This supplements the already-passing repository validator, distribution build, archive-integrity check, and independent structured review. GUI UAT remains explicitly separate from this app-server/CLI proof.

@AlexMikhalev

Copy link
Copy Markdown
Author

Updated the submission to Terraphim Skills Introduction v0.2.3.

The bundled plugin now uses first-party Terraphim links in end-user collateral, includes the re-signed v1.0.2 Community skills, and preserves GitHub only as machine-readable source provenance.

Validation repeated after rebasing onto current upstream main:

  • python3 scripts/validate.py — 22 plugins passed
  • python3 scripts/build_dist.py — built v0.2.3 package, SHA-256 3b249c96a65b…
  • tsm validate — passed for all three signed Community skills
  • git diff --check — passed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant