Skip to content

feat!: migrate VMind to portable visualization Skills - #299

Open
666haiwen wants to merge 4 commits into
developfrom
codex/migrate-chart-table-skills
Open

666haiwen wants to merge 4 commits into
developfrom
codex/migrate-chart-table-skills

Conversation

@666haiwen

Copy link
Copy Markdown
Contributor

Summary

Repurpose VMind as the public maintenance repository for Agent-facing visualization Skills. Users can install vchart-skill or vtable-skill independently to generate editable chart/table HTML and diagnose configurations. Retire the SDK from the current source tree while preserving its Git history, tags and historical releases.

  • Package self-contained Skill instructions, references, templates and scripts; pin VTable templates and evaluation assets to 1.26.8.
  • Provide bilingual installation/evaluation guides, direct Codex and Claude Code debugging instructions, and an optional bounded OpenAI-compatible model API harness with custom tasks and execution/usage logs.
  • Organize 32 VChart and 4 VTable cases by Skill, with fixed prompts, bundled inputs and focused acceptance criteria.
  • Add deterministic regression and browser-smoke CI using public, pinned dependencies. CI makes no model calls and retains diagnostic artifacts.
  • Use repository-level release tags for both Skills and keep Skill release versions separate from library dependency versions.

Validation

  • 106 Python regression tests passed; Ruff and both Skill validators passed.
  • Fixed VChart/VTable browser smoke passed after the rename using isolated Skill copies and locally served pinned assets.
  • VTable 1.26.8 fixed-example checks passed for sorting, pivot values, filtering and diagnosis rendering.
  • All 36 task prompts, inputs and acceptance criteria were preserved through the rename.
  • GitHub Actions has not yet been verified remotely. Deterministic checks do not establish model quality across the full case catalog; real API coverage recorded so far is one VChart case.

Compatibility

This is a breaking repository transition: the current checkout no longer provides the VMind SDK. Existing SDK users should use historical releases. The four commits are retained as separate commits; merge without squashing or rebasing to preserve commit identity and attribution.

Why:
- Make this repository the maintenance home for Agent-facing visualization
  Skills while retaining earlier VMind SDK versions in Git history and releases.

What:
- Replace the legacy SDK and Rush tooling with portable VChart and VTable
  Skills, bundled references, generators and local knowledge search.
- Add per-Skill fixed cases, deterministic regressions and a bounded
  OpenAI-compatible API harness with optional Codex execution.
- Preserve task inputs, usage, observable tool logs and review evidence;
  keep credentials and generated runs outside version control.
- Document installation and debugging in English and Chinese, and replace
  obsolete Rush Git hooks with Python lint and commit-subject checks.

Validation:
- 105 regressions passed across the relevant suites; the 47 template and
  portable-install tests passed again after whitespace cleanup.
- Ruff, uv lock consistency, JavaScript syntax, catalog preservation,
  documented selections and browser snapshot/catalog checks passed.
- Automated evaluation success remains distinct from manual review;
  known case failures and unexecuted coverage are documented separately.

BREAKING CHANGE: the current source tree no longer provides the VMind SDK.
Use an existing SDK release for the historical SDK API.

Codex-Model: gpt-6-astra
Add deterministic regression and browser jobs with pinned public npm assets and retained diagnostics. Upgrade VTable templates and evaluation assets to stable 1.26.8, verified locally across list, pivot, filter and diagnosis examples.

Codex-Model: gpt-6-astra
Rename the installable Skills to vchart-skill and vtable-skill, keeping directory names, frontmatter, case catalogs, runner selection and bilingual usage guides consistent. Preserve all task prompts, inputs, acceptance criteria and source provenance.

Validation: 106 Python regressions, both Skill validators and fixed VChart/VTable browser smoke passed; staged changes verified as renames only apart from migration records.

Codex-Model: gpt-6-astra
Document shared release tags for vchart-skill and vtable-skill so users can identify Skill snapshots independently of library dependency versions. Preserve historical VMind SDK tags and use tags or commit SHAs for traceability.

Codex-Model: gpt-6-astra
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant