skill-lifecycle-manager

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill Lifecycle Manager

Skill 生命周期管理器

Classify repository skills by lifecycle stage and readiness gates.

Scope: Read-only lifecycle reporting. Does not edit skills, run installs, or mutate catalog indexes.

根据生命周期阶段和就绪标准对仓库中的Skill进行分类。

适用范围： 只读式生命周期报告。不会编辑Skill、执行安装操作或修改目录索引。

Dispatch

调用方式

$ARGUMENTS	Action
`<name>`	Lifecycle report for one skill
`repo` / `--all`	Summary for every `skills/*/` directory
`--format json`	Machine-readable report
Empty	Show stage definitions and example commands

$ARGUMENTS	操作
`<name>`	单个Skill的生命周期报告
`repo` / `--all`	所有 `skills/*/` 目录的汇总报告
`--format json`	机器可读格式的报告
无参数	显示阶段定义和示例命令

Lifecycle Stages

生命周期阶段

Stage	Signals
`draft`	TODO description, missing evals, or failing `scripts/check.py` contract
`internal`	`metadata.internal: true`
`active`	Valid frontmatter, eval manifest, and portable validator present
`deprecated`	Body or metadata marks deprecation (maintainer-authored)

阶段	判断信号
`draft`	存在待完成描述、缺少评估或 `scripts/check.py` 验证未通过
`internal`	`metadata.internal: true`
`active`	具备有效的前置元数据（frontmatter）、评估清单和可移植验证器
`deprecated`	内容或元数据标记了弃用（由维护者添加）

Workflow

工作流程

bash

uv run python skills/skill-lifecycle-manager/scripts/lifecycle_report.py <name>
uv run python skills/skill-lifecycle-manager/scripts/lifecycle_report.py --all --format json

Pair lifecycle output with

/skill-creator audit

before promotion.

bash

uv run python skills/skill-lifecycle-manager/scripts/lifecycle_report.py <name>
uv run python skills/skill-lifecycle-manager/scripts/lifecycle_report.py --all --format json

在升级Skill前，需将生命周期报告与

/skill-creator audit

配合使用。

Validation Contract

验证约定

bash

uv run python skills/skill-lifecycle-manager/scripts/check.py

bash

uv run python skills/skill-lifecycle-manager/scripts/check.py

Critical Rules

核心规则

Never auto-promote a skill based on lifecycle heuristics alone.
Treat missing evals as a draft signal, not a hard block for internal skills.
Do not mutate
```
metadata.internal
```
or catalog authoring rows from this skill.
Run the repo validation command before declaring a skill active-ready.
Route executable fixes to skill-creator or the maintainer lead.

绝不能仅基于生命周期启发式规则自动升级Skill。
将缺少评估视为草稿信号，但不以此阻止内部Skill的使用。
不得通过此Skill修改
```
metadata.internal
```
或目录创作行。
在宣布Skill进入活跃就绪状态前，需执行仓库验证命令。
可执行修复操作需交由skill-creator或维护负责人处理。