技能生命周期治理技能
权威的技能生命周期状态模型，确保代理不引入无效状态或非法转换。
该技能描述了权限边界和治理操作，但作为知识文档，不涉及执行权限。它清晰列出了谁可以执行哪些操作，并强调了审核流程和审计日志，但缺少用户确认或数据流透明的细节。扣分因为缺少对数据流和敏感数据处理的明确披露。
该文档提供了清晰的状态转换和代码引用，关键路径（如发布、审核、撤回）描述具体。但未包含测试或失败反馈示例，静态审查无法验证执行，因此扣分。
该技能明确定义了触发条件和适用场景，但未说明非适用范围的边界。环境适配方面，其描述不依赖海外服务，因此没有扣分。
文档结构清晰，包含状态模型、转换、权限边界和常见陷阱，但缺少安装/依赖说明、版本更新和变更日志。扣分因为缺少维护责任和更新路径。
该技能作为参考文档能够回答生命周期相关问题，但直接可用性有限，因为未提供具体输出或示例。扣分因为产出物不明确。
该技能引用了具体代码文件和设计文档，但未提供独立验证材料或测试证据，因此证据强度有限。
- 该技能仅为知识文档，不包含可执行代码，实际使用时需人工转换或结合代码库。
- 发布者未经验证，建议独立核实来源和更新支持。
- 技能引用内部代码和设计文档，但未提供独立测试或验证，静态审查无法确认其准确性。
这个 Skill 能做什么，适合哪些场景？
此技能提供了技能容器、版本、审查任务和可见性状态的完整生命周期状态模型，以及所有允许的状态转换和治理操作（如隐藏、yank、归档）。它基于 SkillHub 代码库和设计文档，明确指出了设计意图与当前代码实现之间的差异（例如 hidden 字段应作为布尔叠加而非枚举状态）。该技能是纯参考性知识，不执行任何操作，仅用于指导代理在修改发布、审查或取消发布流程时遵循正确的状态机和权限边界。
此技能提供权威的状态定义（如 SkillStatus、SkillVersionStatus、ReviewTaskStatus、SkillVisibility），枚举所有合法状态转换及其触发条件（如首次上传、审查批准/拒绝、撤回、yank、隐藏、归档），指定最新版本指针的计算规则（yank 后的重新计算），定义读模型（headlineVersion、publishedVersion 等）和权限边界（谁可以撤回、删除、归档、隐藏等）。它还记录了领域事件（如 SkillPublishedEvent）和常见陷阱（如直接设置 HIDDEN 状态、忘记重算 latestVersionId）。
- 开发者在修改技能发布流程时，需要确认新的状态转换是否符合已定义的合法转换表。
- 后端工程师在添加或更改技能/版本状态字段时，需要参考权威的状态枚举和设计说明。
- 实现治理动作（如隐藏、yank、归档）的工程师需要确认操作的正确实现方式和权限要求。
- 在搜索或详情页显示技能状态时，需要了解如何选择正确的投影版本（publishedVersion 等）。
- 审查添加新状态转换或权限检查的代码时，需要对照此技能检查是否违反设计规则。
这个 Skill 有哪些优点和局限？
- 提供权威的状态模型，减少设计不一致
- 明确列出设计意图与代码实现的差异，指导新代码编写
- 包含详细的转换表、权限边界和常见陷阱，非常实用
- 作为文档型技能，易于集成到任何代理工作流
- 仅适用于 SkillHub 平台，不适用于其他注册表
- 没有提供可执行脚本或测试用例，仅作为参考
- 依赖特定代码库的类名和文档，可能需要更新以保持同步
- 未覆盖所有可能的边缘情况，如并发发布场景
如何安装这个 Skill？
此技能是一个文档型技能，没有可执行文件。要使用它，请将 .agents/skills/skill-lifecycle 文件夹放置在您的代理技能目录中。如果使用 SkillHub 注册表，可以通过 CLI 安装（如 skillhub install skill-lifecycle --agent codex）。
如何使用这个 Skill？
在需要修改技能发布、审查或取消发布流程时，提示您的代理参考此技能。例如：'请查看 skill-lifecycle 技能，确保新状态转换符合规范。' 代理将依据技能中的状态模型和转换表来验证您的代码或设计。
这个 Skill 与同类方案有什么区别？
无。该技能基于 SkillHub 的内部设计，没有明确提到其他类似产品。