fix: resolve all remaining issues for release v0.0.2-beta.1#16
Merged
Conversation
This PR delivers a comprehensive upgrade transforming the skill suite from
a documentation-driven reference into an automated development toolkit.
- Parameterized code generator (336 combinations: 6 strategies x 7 frameworks x 2 Bowl x 4 scenes)
- BM25 search engine with 51 known issues database (8C + 11H + 20M + 12L)
- CLI skeleton: gskill init/uninstall/generate/versions/update (5 commands)
- Multi-platform support: 10 AI platform configs (Claude, Cursor, Windsurf, etc.)
- Single-command sync: _sync_all.py with --apply/--verify modes
- Root SKILL.md: developer roadmap, 5-question decision tree, anti-patterns
- All 5 sub-skill SKILL.md: narrative workflows, pre-delivery checklists, anti-pattern tables
- CLAUDE.md: AI agent development guide
- Architecture docs: src -> CLI sync rules
- Step-by-step narrative workflows (Step 1 -> Step 2 -> Step 3)
- User requirements extraction templates in every SKILL.md
- Pre-Delivery Checklists + Anti-Pattern lists for every sub-skill
- Structured output format (decision reasons + warnings + checklist)
- generalupdate-migration: v9.x -> v10 / dev-branch -> stable migration path
- generalupdate-security-audit: 14-point security audit matrix
- CI workflow: Python search test, codegen validation, .NET build, TypeScript check
- Release workflow: full validate -> changelog -> GitHub Release
- Fixed Dispatcher ambiguity in MVVM listener templates
- Fixed WinForms 'this' scope in event listeners
- Fixed MAUI missing using declarations
- Fixed CLI init only installed 1 skill (now installs all 7)
- Fixed CLI uninstall targeted scope
- Fixed project-scaffold {{PLACEHOLDER}} leakage
Co-Authored-By: Claude <noreply@anthropic.com>
- fix: 'bate' → 'beta' typo in skill.json, plugin.json, marketplace.json - fix: skill.json version desc v10.4.6 → v10.5.0-beta.4 - fix: template.ts missing readFile import, platform path hardcoding - fix: init.ts --ai all now routes to generateAllPlatformFiles - fix: generate.ts command injection (execSync→spawnSync+argv) - fix: extract.ts path injection (exec→execFile) - fix: _sync_all.py filecmp shallow=False + --verify detects NEEDS SYNC - fix: release.yml Windows paths on Linux runner - fix: sync CLI assets after source changes Co-Authored-By: Claude <noreply@anthropic.com
- Unify version to 0.0.2-beta.1 across all manifests (SKILL.md, skill.json, plugin.json, marketplace.json, READMEs) - Fix 'bate' typo to 'beta' in all docs - Install CLI deps and fix TypeScript type error in uninstall.ts - Run asset sync (_sync_all.py) and verify pass - Update BowlIntegration.cs template to match real API (BowlContext record struct, DumpType, Normalize(), OnCrash callback) - Verify Bowl LaunchAsync API: public Task<BowlResult> LaunchAsync( BowlContext, CancellationToken = default) - Verify NuGet type conflict (CS0433) resolved in v10.5.0-beta.4 — Bowl and Core use independent namespaces, no Common.dll collision - Update BUGS.md with verified status for both issues - CRITICAL: Upgrade code generator templates from v10.4.6 API to v10.5.0-beta.4: - Bootstrap.cs.template: Configinfo -> UpdateRequest - listeners_console.cs.template: IsComplated -> IsCompleted - bowl_notice.cs.template: deprecated MonitorParameter -> BowlContext - DeploymentChecklist.md.template: Configinfo -> UpdateRequest - generate.py: remove outdated v10.4.6 comments and IsComplated refs - Create RELEASE_CHECKLIST.md as 50+ item pre-release checklist - Full validation: 15/15 search tests, 336 codegen combos, 3 strategy smoke tests, CLI TypeScript compile, sync verify all pass Co-Authored-By: Claude <noreply@anthropic.com>
All 15 conflicts were add/add between our v10.5.0-beta.4 API changes and main's outdated v10.4.6 code. Accepted ours (HEAD) in all cases — the correct v10.5 API changes. Co-Authored-By: Claude <noreply@anthropic.com>
JusterZhu
added a commit
that referenced
this pull request
Jun 16, 2026
)" This reverts commit 9087964.
There was a problem hiding this comment.
Pull request overview
This PR prepares the repository for the v0.0.2-beta.1 beta release by updating skill metadata/docs and refreshing generated templates and CLI tooling to target the GeneralUpdate v10.5.0-beta.4 API.
Changes:
- Adds/updates release documentation, architecture notes, and version strings across skill manifests and READMEs.
- Introduces a TypeScript-based
gskillCLI (init/generate/update/uninstall/versions) plus bundledcli/assets/templates/data/scripts. - Updates generator templates and skill content to align with the
v10.5.0-beta.4surface (UpdateRequest, listeners, Bowl API notes).
Reviewed changes
Copilot reviewed 22 out of 23 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| skill.json | Adds skill marketplace metadata (name/version/platforms/skills/install command). |
| RULES.md | Expands repo usage rules (navigation, codegen, search, conventions). |
| RELEASE_CHECKLIST.md | Adds a comprehensive pre-release checklist and validation commands. |
| README.md | Fixes bate→beta and updates displayed version. |
| README.en.md | Fixes bate→beta and updates displayed version/date. |
| README.zh-Hans.md | Fixes bate→beta and updates displayed version. |
| docs/architecture-data-flow.md | Documents source-of-truth vs synced assets and release sync flow. |
| .gitignore | Adds ignore rules for Python/Node/.NET build artifacts. |
| BUGS.md | Updates audit status and documents resolved items for v10.5. |
| CLAUDE.md | Adds AI-agent repo guidance and workflow notes. |
| .github/workflows/release.yml | Adds a release workflow to validate/build/sync and publish a GitHub Release. |
| cli/tsconfig.json | Adds TS compiler configuration for the CLI build output. |
| cli/package.json | Adds CLI package manifest (name/bin/scripts/deps). |
| cli/src/index.ts | Implements the CLI entrypoint and command wiring. |
| cli/src/types/index.ts | Defines CLI types (AIType/PlatformConfig/Release) and folder mappings. |
| cli/src/utils/logger.ts | Adds a minimal colored logger utility. |
| cli/src/utils/github.ts | Adds GitHub Releases fetch/download helpers and rate-limit error types. |
| cli/src/utils/extract.ts | Adds zip extraction + folder copy utilities for install/update flows. |
| cli/src/utils/detect.ts | Adds detection logic to infer which AI platform(s) are present. |
| cli/src/utils/template.ts | Implements skill installation by copying bundled assets into platform folders. |
| cli/src/commands/init.ts | Adds interactive/non-interactive install command (project/global, optional generator). |
| cli/src/commands/generate.ts | Adds a command that delegates to the Python generator. |
| cli/src/commands/update.ts | Adds an update command that pulls latest release and reinstalls with force. |
| cli/src/commands/uninstall.ts | Adds an uninstall command for removing installed skill folders. |
| cli/src/commands/versions.ts | Adds a command to list versions from GitHub Releases. |
| cli/assets/templates/base/skill-content.md | Base markdown template used by legacy per-platform installs. |
| cli/assets/templates/platforms/claude.json | Platform install metadata for Claude Code. |
| cli/assets/templates/platforms/cursor.json | Platform install metadata for Cursor. |
| cli/assets/templates/platforms/windsurf.json | Platform install metadata for Windsurf. |
| cli/assets/templates/platforms/copilot.json | Platform install metadata for GitHub Copilot. |
| cli/assets/templates/platforms/kiro.json | Platform install metadata for Kiro. |
| cli/assets/templates/platforms/roocode.json | Platform install metadata for RooCode. |
| cli/assets/templates/platforms/codex.json | Platform install metadata for Codex. |
| cli/assets/templates/platforms/gemini.json | Platform install metadata for Gemini CLI. |
| cli/assets/templates/platforms/continue.json | Platform install metadata for Continue. |
| cli/assets/templates/platforms/agent.json | Platform install metadata for Antigravity/generic agent. |
| cli/assets/scripts/core.py | Bundled BM25 core used by the troubleshooting search. |
| cli/assets/scripts/search.py | Bundled search CLI wrapper for BM25 troubleshooting. |
| cli/assets/data/strategies.csv | Bundled strategy dataset for search/lookup. |
| cli/assets/scripts/generate/templates/Bootstrap.cs.template | Generator bootstrap template updated for v10.5 API. |
| cli/assets/scripts/generate/templates/DeploymentChecklist.md.template | Generator deployment checklist template. |
| cli/assets/scripts/generate/templates/IssuesWarning.md.template | Generator known-issues warning template. |
| cli/assets/scripts/generate/templates/UpgradeProgram.cs.template | Generator upgrade entrypoint template. |
| cli/assets/scripts/generate/templates/manifest.json.template | Generator manifest template. |
| cli/assets/scripts/generate/templates/bowl_notice.cs.template | Generator Bowl notice snippet. |
| cli/assets/scripts/generate/templates/listeners_console.cs.template | Generator console listeners snippet. |
| cli/assets/scripts/generate/templates/listeners_maui.cs.template | Generator MAUI listeners snippet. |
| cli/assets/scripts/generate/templates/listeners_mvvm.cs.template | Generator MVVM listeners snippet. |
| cli/assets/scripts/generate/templates/listeners_winforms.cs.template | Generator WinForms listeners snippet. |
| cli/assets/skills/generalupdate-init/templates/MinimalIntegration.cs | Bundled minimal integration example updated for v10.5 API. |
| cli/assets/skills/generalupdate-init/templates/FullIntegration.cs | Bundled full integration example updated for v10.5 API. |
| cli/assets/skills/generalupdate-init/templates/generalupdate.manifest.json | Bundled manifest template. |
| cli/assets/skills/generalupdate-init/project-scaffold/ClientApp.csproj | Bundled client project scaffold. |
| cli/assets/skills/generalupdate-init/project-scaffold/ClientProgram.cs | Bundled client scaffold program using v10.5 API. |
| cli/assets/skills/generalupdate-init/project-scaffold/UpgradeApp.csproj | Bundled upgrade project scaffold. |
| cli/assets/skills/generalupdate-init/project-scaffold/UpgradeProgram.cs | Bundled upgrade scaffold program. |
| cli/assets/skills/generalupdate-ui/templates/DownloadViewModels.cs | Bundled MVVM viewmodel template for UI state coverage. |
| cli/assets/skills/generalupdate-ui/templates/LayUIStyle.xaml | Bundled WPF LayUI window template. |
| cli/assets/skills/generalupdate-ui/templates/WPFDevelopersStyle.xaml | Bundled WPFDevelopers window template. |
| cli/assets/skills/generalupdate-ui/templates/WpfDevelopersViewModel.cs | Bundled WPFDevelopers viewmodel template. |
| cli/assets/skills/generalupdate-ui/templates/SemiUrsaClientView.axaml | Bundled Avalonia SemiUrsa client window template. |
| cli/assets/skills/generalupdate-ui/templates/SemiUrsaUpgradeView.axaml | Bundled Avalonia SemiUrsa upgrade window template. |
| cli/assets/skills/generalupdate-ui/templates/MauiUpdatePage.xaml | Bundled MAUI update page markup template. |
| cli/assets/skills/generalupdate-ui/templates/MauiUpdatePage.xaml.cs | Bundled MAUI viewmodel template using v10.5 API. |
| cli/assets/skills/generalupdate-strategy/examples/ClientServerStrategy.cs | Bundled strategy example updated for v10.5 API. |
| cli/assets/skills/generalupdate-strategy/examples/OssStrategy.cs | Bundled OSS strategy example updated for v10.5 API. |
| cli/assets/skills/generalupdate-strategy/examples/SilentStrategy.cs | Bundled silent strategy example updated for v10.5 API. |
| cli/assets/skills/generalupdate-strategy/examples/DifferentialStrategy.cs | Bundled differential strategy example updated for v10.5 API. |
| cli/assets/skills/generalupdate-strategy/examples/CrossVersionStrategy.cs | Bundled CVP strategy example updated for v10.5 API. |
| cli/assets/skills/generalupdate-strategy/examples/PushStrategy.cs | Bundled SignalR push strategy example updated for v10.5 API. |
| cli/assets/skills/generalupdate-troubleshoot/SKILL.md | Bundled troubleshooting skill content. |
| cli/assets/skills/generalupdate-troubleshoot/scripts/core.py | Bundled troubleshooting search core. |
| cli/assets/skills/generalupdate-troubleshoot/scripts/search.py | Bundled troubleshooting search CLI. |
| cli/assets/skills/generalupdate-troubleshoot/data/strategies.csv | Bundled troubleshooting strategies dataset. |
| cli/assets/skills/generalupdate-migration/SKILL.md | Bundled migration guidance skill content. |
| cli/assets/skills/generalupdate-security-audit/SKILL.md | Bundled security audit skill content. |
| cli/assets/skills/generalupdate-advanced/templates/NamedPipeIPC.cs | Bundled advanced template for IPC reference. |
| cli/assets/skills/generalupdate-advanced/templates/CustomStrategy.cs | Bundled advanced template for custom strategy. |
| cli/assets/skills/generalupdate-advanced/templates/CustomHooks.cs | Bundled advanced template for custom hooks. |
| cli/assets/skills/generalupdate-advanced/templates/BowlIntegration.cs | Bundled advanced template for Bowl integration. |
| cli/assets/skills/generalupdate-advanced/reference.md | Bundled advanced reference documentation. |
| .claude/skills/generalupdate-init/SKILL.md | Updates init skill with requirement extraction + validation checklists. |
| .claude/skills/generalupdate-init/templates/MinimalIntegration.cs | Updates source minimal integration template placeholders. |
| .claude/skills/generalupdate-init/templates/FullIntegration.cs | Updates source full integration template placeholders. |
| .claude/skills/generalupdate-init/templates/generalupdate.manifest.json | Updates source manifest template placeholders. |
| .claude/skills/generalupdate-init/project-scaffold/ClientProgram.cs | Updates source scaffold client program defaults/docs. |
| .claude/skills/generalupdate-ui/SKILL.md | Adds UI requirement extraction + integration validation checklist. |
| .claude/skills/generalupdate-troubleshoot/SKILL.md | Adds BM25 workflow + diagnostic checklists/antipatterns. |
| .claude/skills/generalupdate-troubleshoot/scripts/core.py | Adds BM25 core implementation. |
| .claude/skills/generalupdate-troubleshoot/scripts/search.py | Adds BM25 CLI wrapper. |
| .claude/skills/generalupdate-troubleshoot/data/strategies.csv | Adds strategies dataset. |
| .claude/skills/generalupdate-strategy/SKILL.md | Adds strategy requirement extraction + detailed decision tree/checklists. |
| .claude/skills/generalupdate-migration/SKILL.md | Adds migration skill content. |
| .claude/skills/generalupdate-security-audit/SKILL.md | Adds security audit skill content. |
| .claude/skills/generalupdate-advanced/SKILL.md | Adds advanced requirement extraction + validation checklists. |
| .claude/skills/generalupdate-advanced/templates/BowlIntegration.cs | Updates Bowl integration template to match v10.5 API docs. |
| .claude/scripts/_sync_all.py | Adds a single entrypoint sync script for .claude/ → cli/assets/. |
| .claude/scripts/generate/templates/Bootstrap.cs.template | Updates source generator bootstrap template. |
| .claude/scripts/generate/templates/DeploymentChecklist.md.template | Updates source generator checklist template. |
| .claude/scripts/generate/templates/IssuesWarning.md.template | Updates source generator issues warning template. |
| .claude/scripts/generate/templates/UpgradeProgram.cs.template | Updates source generator upgrade template. |
| .claude/scripts/generate/templates/manifest.json.template | Updates source generator manifest template. |
| .claude/scripts/generate/templates/bowl_notice.cs.template | Updates source generator Bowl notice template. |
| .claude/scripts/generate/templates/listeners_console.cs.template | Updates source generator console listeners template. |
| .claude/scripts/generate/templates/listeners_maui.cs.template | Updates source generator MAUI listeners template. |
| .claude/scripts/generate/templates/listeners_mvvm.cs.template | Updates source generator MVVM listeners template. |
| .claude/scripts/generate/templates/listeners_winforms.cs.template | Updates source generator WinForms listeners template. |
| .claude-plugin/plugin.json | Updates Claude plugin metadata and version. |
| .claude-plugin/marketplace.json | Updates marketplace metadata and version. |
Files not reviewed (1)
- cli/package-lock.json: Generated file
Comments suppressed due to low confidence (1)
cli/src/commands/uninstall.ts:40
uninstallremoves/<root>/skills/<skillName>, butinitinstalls to/<root>/<skillSubdir>/generalupdate-skill/<skillName>(and uses non-skillssubdirs for Copilot/Kiro). As a result, uninstall will typically report “No skill files found to remove” even after a successful install.
async function removeSkillDir(baseDir: string, aiType: Exclude<AIType, 'all'>): Promise<string[]> {
const folders = AI_FOLDERS[aiType];
const removed: string[] = [];
for (const folder of folders) {
for (const skillName of SKILL_NAMES) {
const skillDir = join(baseDir, folder, 'skills', skillName);
try {
await stat(skillDir);
await rm(skillDir, { recursive: true, force: true });
removed.push(`${folder}/skills/${skillName}`);
} catch (err: unknown) {
if ((err as NodeJS.ErrnoException).code !== 'ENOENT') throw err;
}
}
}
return removed;
}
|
|
||
| ## 🧪 Validation | ||
|
|
||
| > Run `python3 .claude/scripts/generate.py --list` to confirm all 288 combinations resolve. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Resolves all remaining issues preventing a beta release of GeneralUpdate Skill CodeGen. Comprehensive fix covering version alignment, API correctness, CLI build, and code generator template upgrade.
Changes
Version & Identity
0.0.2-beta.1across all 7 manifestsbatetypo →betain all docsCode Generator Fix (CRITICAL)
Upgraded generator templates from v10.4.6 API to v10.5.0-beta.4:
Bootstrap.cs.template:Configinfo+Common.Shared.Object→UpdateRequest+Core.Configurationlisteners_console.cs.template:IsComplated→IsCompletedbowl_notice.cs.template: deprecatedMonitorParameter→BowlContext+DumpTypeDeploymentChecklist.md.template:Configinfo→UpdateRequestgenerate.py: removed outdated v10.4.6 commentsBowl & NuGet Conflict Verification
Bowl.LaunchAsyncreal API signature matches templatesBUGS.mdwith confirmed resolution statusCLI
uninstall.tsgskill --helpconfirmed workingDevOps
_sync_all.py→ verify passes (source → CLI assets)RELEASE_CHECKLIST.md: 50+ item pre-release checklistValidation Results
Configinfo,Common.Shared)Closes: The remaining issues identified in the release readiness audit.