platform-skill-lifecycle-manager

01 前言 Front Matter

name: platform-skill-lifecycle-manager
owner: pm
scope: common
status: active
version: 1.0.3
metadata: { "type": "process", "triggers": [ "create platform skill", "new .claude skill", "new .gemini skill", "platform skill version", "platform skill lifecycle", "update platform skill" ] }
description: Manages the creation, versioning, and propagation of platform skills in .claude/skills/ and .gemini/skills/ directories. Use when: creating new platform skills, updating platform skill versions, or ensuring propagation to templates/common/.
last_reviewed: 1794096000000

03 SKILL.md 正文

Platform Skill Lifecycle Manager

When to Use

Use this skill when:

Creating a new skill in .claude/skills/ or .gemini/skills/
Updating an existing platform skill's version
Ensuring a platform skill is propagated to templates/common/

Creation Checklist

When creating a new platform skill (SKILL.md):

Initialize version: Add version: 1.0.0 to frontmatter
Dual platform: Create in BOTH .claude/skills/<name>/SKILL.md AND .gemini/skills/<name>/SKILL.md
Propagate to common: Copy to templates/common/.claude/skills/<name>/SKILL.md AND templates/common/.gemini/skills/<name>/SKILL.md
Register in AGENTS.md: Add row to ## Skills table
Register in common-contract.json: Add entry to common_platform_skills section
Run verification: bun scripts/verify-platform-lifecycle.ts must pass Check E, F, H

Version Bump Rules

Change Type	Version Bump
New skill created	Initialize `version: 1.0.0`
Trigger or description update	patch (1.0.0 → 1.0.1)
New procedures or sections added	minor (1.0.0 → 1.1.0)
Fundamental role change	major (1.0.0 → 2.0.0)

When bumping version: update ALL 4 files (.claude/skills/, .gemini/skills/, both templates/common/ copies).

Propagation Rule

Every platform skill must exist in 4 locations:

.claude/skills/<name>/SKILL.md
.gemini/skills/<name>/SKILL.md
templates/common/.claude/skills/<name>/SKILL.md
templates/common/.gemini/skills/<name>/SKILL.md

verify-platform-lifecycle.ts Check H verifies propagation.

Verification

bun scripts/verify-platform-lifecycle.ts

04 同仓库更多 Skills

5throck/ai-workspace-standards

Scans, updates, and upgrades Bun dependencies and packages across the AI workspace (L0) or standalone project (L2/L3) while ensuring lockfile consistency, package.json version bumps, and security compliance. Use when: updating bun dependencies, upgrading packages to @latest, checking outdated packages in workspace or templates.

★ 25

5throck/ai-workspace-standards

ui-ux-design-intelligence

Provides comprehensive UI/UX design capabilities including design system creation, component design, visual hierarchy, and user-centered design principles. Use when: building design systems, creating visual designs, designing UI components, or establishing design specifications.

★ 25

5throck/ai-workspace-standards