KS
Killer-Skills

openspec-archive-change — how to use openspec-archive-change how to use openspec-archive-change, openspec-archive-change setup guide, openspec-archive-change vs manual archiving, openspec-archive-change install, what is openspec-archive-change, openspec-archive-change alternative, openspec-archive-change CLI commands, openspec-archive-change for AI agents, openspec-archive-change workflow automation

v1.0
GitHub

About this Skill

Ideal for Development Agents requiring efficient archive management and automated change tracking using CLI commands. openspec-archive-change is a skill that automates the archiving of completed changes in experimental workflows, using CLI commands like openspec list and openspec status to manage artifacts and schemas.

Features

Runs openspec list --json to retrieve available changes
Uses AskUserQuestion tool to prompt user for change selection
Checks artifact completion status with openspec status --change "<name>" --json
Parses JSON to understand schemaName and artifact status
Displays warnings and lists incomplete artifacts using AskUserQuestion tool

# Core Topics

StrayDragon StrayDragon
[0]
[0]
Updated: 3/6/2026

Quality Score

Top 5%
38
Excellent
Based on code quality & docs
Installation
SYS Universal Install (Auto-Detect)
Cursor IDE Windsurf IDE VS Code IDE
> npx killer-skills add StrayDragon/llman/openspec-archive-change

Agent Capability Analysis

The openspec-archive-change MCP Server by StrayDragon is an open-source Categories.community integration for Claude and other AI agents, enabling seamless task automation and capability expansion. Optimized for how to use openspec-archive-change, openspec-archive-change setup guide, openspec-archive-change vs manual archiving.

Ideal Agent Persona

Ideal for Development Agents requiring efficient archive management and automated change tracking using CLI commands.

Core Value

Empowers agents to automate archive management for experimental workflows, utilizing openspec-archive-change to efficiently track and manage changes, artifacts, and schema using JSON output and AskUserQuestion tools for seamless user interaction.

Capabilities Granted for openspec-archive-change MCP Server

Automating archive changes for completed workflows
Managing artifacts and schema for experimental projects
Streamlining development workflows with CLI commands

! Prerequisites & Limits

  • Requires openspec installation and configuration
  • Limited to active and unarchived changes
  • User confirmation required for changes with incomplete artifacts
Project
SKILL.md
3.4 KB
.cursorrules
1.2 KB
package.json
240 B
Ready
UTF-8

# Tags

[No tags]
SKILL.md
Readonly

在实验性工作流中归档已完成的变更。

输入:可选指定变更名称。如果省略,先判断是否可从对话上下文推断;若含糊或不明确,必须提示可用的变更。

步骤

  1. 如果未提供变更名称,提示进行选择

    运行 openspec list --json 获取可用变更。使用 AskUserQuestion 工具 让用户选择。

    仅显示活动中的变更(未归档)。 如可用,包含每个变更使用的 schema。

    重要:不要猜测或自动选择变更。始终让用户选择。

  2. 检查工件完成状态

    运行 openspec status --change "<name>" --json 检查工件完成情况。

    解析 JSON 以了解:

    • schemaName:正在使用的工作流
    • artifacts:工件列表及其状态(done 或其他)

    如果存在未完成工件:

    • 显示警告并列出未完成工件
    • 使用 AskUserQuestion 工具 确认是否继续
    • 用户确认后继续
  3. 检查任务完成状态

    读取任务文件(通常为 tasks.md)以检查未完成任务。

    统计 - [ ](未完成)与 - [x](完成)。

    如果存在未完成任务:

    • 显示警告并提示未完成任务数量
    • 使用 AskUserQuestion 工具 确认是否继续
    • 用户确认后继续

    如果没有任务文件: 跳过任务相关警告。

  4. 评估 delta 规范同步状态

    检查 openspec/changes/<name>/specs/ 下是否存在 delta 规范。若不存在,则无需提示同步。

    如果存在 delta 规范:

    • 将每个 delta 规范与对应的主规范 openspec/specs/<capability>/spec.md 进行比较
    • 判断会应用哪些变更(新增、修改、移除、重命名)
    • 在提示前展示合并后的摘要

    提示选项:

    • 若需要同步:"现在同步(推荐)"、"不同步直接归档"
    • 若已同步:"立即归档"、"仍要同步"、"取消"

    如果用户选择同步,执行 /opsx:sync 逻辑(使用 openspec-sync-specs skill)。无论选择如何,继续归档。

  5. 执行归档

    若归档目录不存在,则创建:

    bash
    1mkdir -p openspec/changes/archive

    使用当前日期生成目标名称:YYYY-MM-DD-<change-name>

    检查目标是否已存在:

    • 若存在:报错并建议重命名现有归档或使用不同日期
    • 若不存在:将变更目录移动到归档目录
    bash
    1mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name>
  6. 显示摘要

    显示归档完成摘要,包括:

    • 变更名称
    • 使用的 schema
    • 归档位置
    • 是否已同步规范(如适用)
    • 任何警告(未完成工件/任务)

成功输出

## 归档完成

**变更:** <change-name>
**Schema:** <schema-name>
**归档到:** openspec/changes/archive/YYYY-MM-DD-<name>/
**规范:** ✓ 已同步到主规范(或 "无 delta 规范" 或 "跳过同步")

所有工件完成。所有任务完成。

护栏

  • 若未提供变更名称,始终提示选择
  • 使用工件图(openspec status --json)检查完成情况
  • 不要因警告阻止归档——仅提示并确认
  • 移动时保留 .openspec.yaml(目录整体移动)
  • 清晰展示发生了什么
  • 如果请求同步,使用 openspec-sync-specs 方式(agent 驱动)
  • 若存在 delta 规范,始终进行同步评估并在提示前展示合并摘要

Related Skills

Looking for an alternative to openspec-archive-change or building a Categories.community AI Agent? Explore these related open-source MCP Servers.

View All

widget-generator

Logo of f
f

widget-generator is an open-source AI agent skill for creating widget plugins that are injected into prompt feeds on prompts.chat. It supports two rendering modes: standard prompt widgets using default PromptCard styling and custom render widgets built as full React components.

149.6k
0
Design

chat-sdk

Logo of lobehub
lobehub

chat-sdk is a unified TypeScript SDK for building chat bots across multiple platforms, providing a single interface for deploying bot logic.

73.0k
0
Communication

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

72.8k
0
Communication

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

72.8k
0
Communication