Agent skill

Lina Openspec Archive Changes

by linaproai in linaproai/linapro

扫描并归档已完成的 OpenSpec 活跃变更. An agent skill from linaproai/linapro.

Apache-2.0Auto-check passed

Install Lina Openspec Archive Changes

skills CLI
$ npx skills add linaproai/linapro --skill lina-openspec-archive-changes -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install linaproai/linapro lina-openspec-archive-changes --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/linaproai/linapro.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/lina-openspec-archive-changes .claude/skills/lina-openspec-archive-changes && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
lina-openspec-archive-changes
GitHub stars
160
Token cost
~894 tokens
SKILL.md length
253 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
Apache-2.0

At a glance

扫描并归档已完成的 OpenSpec 活跃变更. An agent skill from linaproai/linapro.

  • Works in 7 steps: 环境 → 候选 → 逐项检查 → …
  • SKILL.md covers 硬规则, 完成门禁(全部满足才可归档), 插件业务规范前缀 and 流程, plus 1 more section
  • Calls git

What it does

Lina Openspec Archive Changes is an agent skill from linaproai/linapro. 扫描并归档已完成的 OpenSpec 活跃变更。 必须用户手动触发,禁止自动触发。

Its SKILL.md is about 890 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: 依赖 OpenSpec CLI,在 LinaPro 仓库根目录执行。

The repository describes itself as: AI-native full-stack framework engineered for sustainable delivery. The licence is Apache-2.0.

Example prompts

  • “/lina-openspec-archive-changes”

Requirements

  • Compatibility (from SKILL.md): 依赖 OpenSpec CLI,在 LinaPro 仓库根目录执行。

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. 环境
  2. 候选
  3. 逐项检查
  4. 预检分类
  5. 归档
  6. 报告
  7. 轻量验证(可选)

What it can do on your machine

Read from SKILL.md and the folder at commit 75395c8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    依赖 OpenSpec CLI,在 LinaPro 仓库根目录执行。

    From compatibility in the SKILL.md frontmatter.

Context cost

Lina Openspec Archive Changes loads about 894 tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 253 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~18
When it runs · the whole SKILL.md, loaded when a task matches
~894

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from linaproai/linapro at commit 75395c8, republished under its Apache-2.0 licence (© linaproai). 253 words, ~894 tokens.

Download SKILL.mdSave it as .claude/skills/lina-openspec-archive-changes/SKILL.md (or your agent's skills folder).
name
lina-openspec-archive-changes
description
扫描并归档已完成的 OpenSpec 活跃变更。 必须用户手动触发,禁止自动触发。
compatibility
依赖 OpenSpec CLI,在 LinaPro 仓库根目录执行。

Lina 自动归档

归档 openspec/changes/ 下已完成的活跃变更(排除 archive/),输出成功/跳过清单。

硬规则

  1. 只扫活跃一级目录,不扫 archive/。
  2. 任务未完成、校验失败或不可安全修复 → 跳过,不强制归档,不用 --no-validate,不手动 mv。
  3. 先全量预检/修复,再归档;单个失败不阻塞其他可归档项(环境级故障除外)。
  4. 不改无关工作区文件;不伪造 tasks.md 完成态;不空写 design.md。
  5. 修复后必须 openspec validate <name> --strict + openspec status --change <name> --json 复验。
  6. 结束时列出:修复项、成功归档路径、跳过原因。

完成门禁(全部满足才可归档)

条件要求
位置openspec/changes/<name>/,name ≠ archive
status 可读openspec status --change <name> --json 成功
必选 artifactproposal / specs / tasks(若存在)为 done/complete/completed
design(可选)缺失 design.md、或 design=ready、或已 done → 均不阻塞。isComplete=false 仅因 design 未写 → 仍可继续。禁止为归档生成占位 design
tasks.md存在;无 - [ ] / - [未完成]
任务统计completedTasks == totalTasks;不等则以 tasks.md 为准,记录差异后继续
MODIFIED/REMOVEDheader 须命中 openspec/specs/<capability>/spec.md;否则走修复
插件业务 specs能力目录必须以 <plugin-id> 开头(见下)
校验openspec validate <name> --strict 通过

无 tasks.md → 跳过(无法判定)。缺 design.md → 不跳过。

无 artifact 明细时,用 openspec list --json 的 status ∈ {complete,completed,done} 辅助判断。

插件业务规范前缀

业务插件 = apps/lina-plugins/<plugin-id>/ 下的具体插件能力。
不含 宿主框架 / lifecycle / governance / pluginbridge / host service / 动态运行时。

  • 从 proposal/design/tasks/specs/路径/plugin.yaml 识别 plugin-id。
  • 插件相关 specs/<capability>/ 必须以 <plugin-id> 或 <plugin-id>-... 命名;归档后 openspec/specs/ 同理。
  • 多插件分目录,不混用无前缀通用名(如 cms)。
  • 主框架能力保持主框架名(如 plugin-framework)。
  • 可安全重命名时:specs/<cap>/ → specs/<plugin-id>-<cap>/ 或 specs/<plugin-id>/,再复验。
  • 无法唯一识别 / 冲突 → 跳过:插件规范目录缺少插件前缀且无法安全自动修复:<capability>。

流程

1. 环境
bash
pwd && test -d openspec/changes && openspec --version && git status --short

CLI 不可用、非仓库根或无 openspec/changes → 停止并说明。

2. 候选
bash
openspec list --json
find openspec/changes -mindepth 1 -maxdepth 1 -type d ! -name archive -exec basename {} \; | sort

CLI + 文件系统合并去重,字母序处理。

3. 逐项检查
bash
openspec status --change "<name>" --json
# 读 openspec/changes/<name>/tasks.md;扫 specs/**

记录:任务完成度、artifact、插件 id、可修复异常、skipReason。

常用原因:任务未完成:a/b · 缺少 tasks.md · artifact 未完成:proposal/specs/tasks · design 可选,已继续 · header 不匹配… · 插件前缀… · 归档失败:…

4. 预检分类
  • ready:门禁全过
  • repair-required:任务完成但有可修异常
  • skipped:未完成 / 不可修

可自动修复(最多 2 轮,每轮后 strict 复验):

  1. 插件 specs 缺前缀 → 安全重命名
  2. MODIFIED header 不匹配 → 对齐主规范文本;确属新增且主规范无同名 → 改 ADDED
  3. REMOVED 主规范已无该条且无有效新增语义 → 删除空 REMOVED 块
  4. CLI 任务数 ≠ tasks.md 但 tasks 已全部完成 + strict 通过 → 记录差异并继续
  5. design 缺失/ready → 不修复,直接可选放行

禁止:改 tasks 勾选、覆盖用户未提交冲突文件、删除有效需求以混过校验。

5. 归档
bash
openspec archive -y "<name>"
  • 用 -y;默认不用 --skip-specs / --no-validate
  • 确认目录已迁至 openspec/changes/archive/YYYY-MM-DD-<name>/
  • 单条失败记原因,继续下一条
6. 报告
markdown
**自动归档结果**

扫描到 N 个活跃变更,自动修复 A 个,成功归档 B 个,跳过 C 个。

自动修复:
- `name`:动作摘要,复验通过

成功归档:
- `name` → `openspec/changes/archive/YYYY-MM-DD-name/`

未归档:
- `name`:原因

无任何可归档项时写明「本次没有归档任何变更」。环境错误示例:未找到 OpenSpec CLI。

7. 轻量验证(可选)
bash
openspec list --json
openspec validate --all

validate --all 因其他未完成变更失败时,勿归咎本次归档,注明范围即可。

边界速查

情况处理
无活跃变更报告即可,不报错
仅未完成列原因,不归档
已在 archive/不扫描
缺 design / design=ready归档,记「design 可选」
工作区已有本地改动可继续;不动无关文件;待归档目录有改动时先提示
归档产生 diff预期结果,不自动 commit

© linaproai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/lina-openspec-archive-changes of linaproai/linapro.

Open the folder on GitHubat commit 75395c8

Compare with similar skills

Lina Openspec Archive Changes next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Lina Openspec Archive Changes compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Lina Openspec Archive Changes this skilllinaproai/linapro160—~894Automated safety check: PassApache-2.0
OpenSpec Bulk Change ArchiverFission-AI/OpenSpec71k2 repos~5.6kAutomated safety check: PassMIT
Openspec Archive Changetsedio/tsed3.1k6 repos~4.1kAutomated safety check: PassMIT
Openspec Verify ChangeFission-AI/OpenSpec71k2 repos~4.6kAutomated safety check: PassMIT
OpenSpec Guided OnboardingFission-AI/OpenSpec71k1 repos~4.5kAutomated safety check: PassMIT
CTF ZIP Archive Key Recoveryzhaoxuya520/reverse-skill40k1 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • Archives several completed OpenSpec changes in one operation, checking the codebase to resolve spec conflicts rather than archiving blindly.

    71k GitHub starsUsed in 2 repos~5.6k tokens
    DevelopmentAuto-check passed
  • Archive a completed OpenSpec change in the experimental workflow.

    3.1k GitHub starsUsed in 6 repos~4.1k tokens
    Auto-check passed
  • Openspec Verify Change

    Fission-AI/OpenSpec

    Verify implementation matches OpenSpec change artifacts. An agent skill from Fission-AI/OpenSpec.

    71k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • OpenSpec Guided Onboarding

    Fission-AI/OpenSpec

    Walks you through a complete OpenSpec workflow cycle with narration while doing real work in your codebase.

    71k GitHub starsUsed in 1 repo~4.5k tokens
    Agent WorkflowsAuto-check passed
  • CTF ZIP Archive Key Recovery

    zhaoxuya520/reverse-skill

    Recovers internal keys from legacy ZipCrypto-protected ZIP archives in CTF challenges through a known-plaintext method, instead of brute force.

    40k GitHub starsUsed in 1 repo~1.5k tokens
    SecurityAuto-check passed
  • Openspec Archive Change

    elastic/terraform-provider-elasticstack

    Official

    Archive a completed change in the experimental workflow. An agent skill from elastic/terraform-provider-elasticstack.

    210 GitHub starsUsed in 86 repos~2.7k tokens
    Auto-check passed

More from linaproai/linapro

All 13 skills in this repo
  • Lina Perf Audit

    linaproai/linapro

    通过 make db.init/mock 重置数据库、重启服务、安装并启用所有内置插件、准备压测数据,并启动并发子代理; 通常需要几十分钟到数小时,且会消耗大量 Token。不得从其他技能、CI、定时任务、 Git 钩子或模糊的性能请求中触发。

    160 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Vben

    linaproai/linapro

    Vben Admin 5.0 前端框架开发技能。用于开发基于 Vue3、Vite、TypeScript 的中后台管理系统。

    160 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check: notes
  • 手动触发:为 LinaPro 主仓库及 apps/lina-plugins 子模块完成提交、PR 前 rebase、推送、创建 PR, 主仓 CI 修复回路,以及 PR 合并后恢复原始分支并同步 main。禁止自动触发。

    160 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Lina Community Fix CI

    linaproai/linapro

    排查并修复给定的 LinaPro GitHub Actions 失败问题;修复完成后保留本地改动, 禁止自动提交、推送或创建 PR。

    160 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • 审查 LinaPro 社区 GitHub Issues,并按项目规范和源码实现分类处理. An agent skill from linaproai/linapro.

    160 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Lina Community New Branch

    linaproai/linapro

    手动触发:将主仓库与 apps/lina-plugins 对齐最新 main 后, 按提示在两侧各建独立分支;分支就绪后继续处理提示词中的后续请求。

    160 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Lina Openspec Archive Changes

What does Lina Openspec Archive Changes do?

扫描并归档已完成的 OpenSpec 活跃变更. An agent skill from linaproai/linapro. Lina Openspec Archive Changes is an agent skill from linaproai/linapro.

How do I install Lina Openspec Archive Changes in Claude Code?

Run `npx skills add linaproai/linapro --skill lina-openspec-archive-changes -a claude-code`. Or copy the skill folder (.agents/skills/lina-openspec-archive-changes in linaproai/linapro) into .claude/skills/lina-openspec-archive-changes in your project. Claude Code loads it when a task matches its description.

How do I install Lina Openspec Archive Changes in Codex?

Run `npx skills add linaproai/linapro --skill lina-openspec-archive-changes -a codex`. Or copy the skill folder (.agents/skills/lina-openspec-archive-changes in linaproai/linapro) into .agents/skills/lina-openspec-archive-changes in your project. Codex loads it when a task matches its description.

Can I use Lina Openspec Archive Changes in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add linaproai/linapro --skill lina-openspec-archive-changes -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/lina-openspec-archive-changes, .gemini/skills/lina-openspec-archive-changes, .github/skills/lina-openspec-archive-changes and .opencode/skills/lina-openspec-archive-changes in your project.

What does Lina Openspec Archive Changes need to run?

Going by SKILL.md and its folder, Lina Openspec Archive Changes needs the command-line tools its instructions call (git). Compatibility (from SKILL.md): 依赖 OpenSpec CLI,在 LinaPro 仓库根目录执行。.

Does Lina Openspec Archive Changes access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Lina Openspec Archive Changes safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Lina Openspec Archive Changes use?

Lina Openspec Archive Changes is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Lina Openspec Archive Changes use?

About 894 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Lina Openspec Archive Changes?

Skills that share tags, products or a category with Lina Openspec Archive Changes: OpenSpec Bulk Change Archiver (Fission-AI/OpenSpec, 71k stars), Openspec Archive Change (tsedio/tsed, 3.1k stars), Openspec Verify Change (Fission-AI/OpenSpec, 71k stars) and OpenSpec Guided Onboarding (Fission-AI/OpenSpec, 71k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Lina Openspec Archive Changes?

linaproai (a GitHub organization) maintains it in linaproai/linapro, which has 160 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 7, 2026.

Source: linaproai/linapro on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.