artifact-lifecycle

Artifact Lifecycle Skill

统一工件生命周期工作流的便捷封装。

Overview

此技能为 .claude/workflows/core/skill-lifecycle.md 中的综合工件生命周期管理工作流提供简化接口。

When to Use

在以下情况下使用此技能：

• 创建新的工件（技能、Agent、钩子、工作流、模板、架构）
• 更新现有工件
• 弃用工件并提供迁移指南
• 检查工件是否已存在

Quick Start

// Invoke this skill
Skill({ skill: 'artifact-lifecycle' });

Workflow Reference

完整工作流： .claude/workflows/core/skill-lifecycle.md

Phases

Phase 1: Discovery

检查工件是否存在，并比较版本。

Agent： architect 输出： 包含建议的发现报告

Phase 2: Decision

确定操作：CREATE、UPDATE 或 DEPRECATE。

Agent： planner 输出： 包含任务的行动计划

Phase 3: Action

执行确定的操作。

Agent： developer + 相应的创建器技能 工具：

• Skill({ skill: "skill-creator" })（用于技能）
• Skill({ skill: "agent-creator" })（用于 Agent）
• Skill({ skill: "hook-creator" })（用于钩子）
• Skill({ skill: "workflow-creator" })（用于工作流）

Phase 4: Integration

更新注册表、目录和 CLAUDE.md。

Agent： developer 更新内容：

• creator-registry.json
• skill-catalog.md（用于技能）
• CLAUDE.md Section 3（用于 Agent）或 Section 8.5/8.6（用于技能/工作流）

Phase 5: Validation

测试集成并验证引用。

Agent： qa 检查项：

• 工件可调用
• 引用有效
• 没有失效的交叉引用

Usage Examples

Create New Skill

User: "Create a skill for Kubernetes deployment"

Router spawns with:
Skill({ skill: "artifact-lifecycle" })

Workflow determines: CREATE mode
Invokes: skill-creator
Updates: registry, catalog, CLAUDE.md
Validates: skill invocable

Update Existing Agent

User: "Update the devops agent to support Terraform Cloud"

Router spawns with:
Skill({ skill: "artifact-lifecycle" })

Workflow determines: UPDATE mode
Version: 1.0.0 → 1.1.0
Updates: agent file, CHANGELOG
Validates: agent referenced correctly

Deprecate Workflow

User: "Deprecate the old deployment workflow"

Router spawns with:
Skill({ skill: "artifact-lifecycle" })

Workflow determines: DEPRECATE mode
Adds: deprecation notice, migration guide
Updates: CLAUDE.md with replacement reference
Validates: no broken references

Configuration

参数	值	默认值
artifact_type	skill、agent、hook、workflow、template、schema	自动检测
operation	create、update、deprecate、integrate	自动检测
version_bump	major、minor、patch	minor

Iron Laws

1. 始终使用特定类型的创建器技能 — 不要将 artifact-lifecycle 当作绕过 research-synthesis、companion-check 或 validation 的捷径；每个阶段都有其存在的理由。
2. 开始执行前始终确定操作模式（CREATE/UPDATE/DEPRECATE）— 未经 Phase 2 确认，不要开始 Phase 3；操作错误会导致工作白费或带来危险。
3. 绝不跳过 Phase 5 验证 — 在将生命周期任务标记为完成前，必须确认工件可调用；将损坏的工件作为完成品交付，比什么都不交付更糟。
4. 始终在 Phase 4 更新目录和 CLAUDE.md — 没有目录条目或路由条目的工件对 Agent 和路由器不可见；未完成注册的集成是不完整的。
5. 不要将 artifact-lifecycle 用于简单的单个工件更新 — 请使用特定类型的更新器（skill-updater、agent-updater、workflow-updater）；生命周期工作流仅用于多阶段编排。

反模式

反模式	失败原因	正确做法
在 CREATE 前跳过 research-synthesis	可能创建重复或过时的工件	始终先运行 research-synthesis
在 Phase 2 决策前开始操作	应执行的操作不正确；需要 UPDATE 时却执行 CREATE	完成 Phase 2 后再进入 Phase 3
跳过 Phase 5 验证	有缺陷的工件被当作完整工件交付	始终运行可调用性检查
在 Phase 4 不更新目录/注册表	Agent 和路由器无法看到该工件	始终更新目录、注册表和 CLAUDE.md
对简单的版本升级使用 artifact-lifecycle	轻量工作采用了繁重流程	UPDATE 模式下使用 skill-updater/agent-updater
不指定 artifact_type	悄无声息地调用了错误的创建器技能	始终在 Phase 1 指定或验证 artifact_type

记忆协议

1. 开始前阅读 .claude/context/memory/learnings.md
2. 将决策记录到 .claude/context/memory/decisions.md
3. 将问题记录到 .claude/context/memory/issues.md

相关技能

• skill-creator - 直接创建技能
• agent-creator - 直接创建 Agent
• workflow-creator - 直接创建工作流
• codebase-integration - 集成外部工件

相关工作流

• .claude/workflows/core/skill-lifecycle.md - 完整生命周期工作流
• .claude/workflows/core/external-integration.md - 外部工件集成
• .claude/workflows/core/router-decision.md - 路由器决策流程