Agent skill

Spec Update

by HHU3637kr in HHU3637kr/skills

当同一个活跃 Spec(位于 spec/versions/<version/specs/<spec-dir/)在当前工作分支内需要小迭代、补充需求、修正方案或优化实现,且原 Spec 目录已有 writer/plan.html + executor/summary.html 时使用。典型信号:'改 writer/plan.html 里漏掉的分页参数''补一条原 Spec 没覆盖的需求''修…

No licenceAuto-check passedDevelopment

Install Spec Update

skills CLI
$ npx skills add HHU3637kr/skills --skill spec-update -a claude-code

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

GitHub CLI
$ gh skill install HHU3637kr/skills spec-update --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/HHU3637kr/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/spec-update .claude/skills/spec-update && 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
spec-update
GitHub stars
145
Token cost
~1.8k tokens
SKILL.md length
412 words
Files
3 (incl. references)
Skills in repo
37
Repo updated
First seen
Licence
None found

At a glance

当同一个活跃 Spec(位于 spec/versions/<version/specs/<spec-dir/)在当前工作分支内需要小迭代、补充需求、修正方案或优化实现,且原 Spec 目录已有 writer/plan.html + executor/summary.html 时使用。典型信号:'改 writer/plan.html 里漏掉的分页参数''补一条原 Spec 没覆盖的需求''修…

  • Works in 9 steps: 同 Spec 原则:update 报告必须放在原 Spec 目录的… → 不归档原则:更新完成后不归档,保留在原目录以便后续更新 → 编号递增:updater/update-001.html →… → …
  • Tasks that involve Git workflow
  • SKILL.md covers 核心原则, 角色续接(必须执行), 确认方式随模式(必须执行) and 报告模板, plus 3 more sections
  • Calls bash and git

What it does

Spec Update is an agent skill from HHU3637kr/skills. 当同一个活跃 Spec(位于 spec/versions/<version/specs/<spec-dir/)在当前工作分支内需要小迭代、补充需求、修正方案或优化实现,且原 Spec 目录已有 writer/plan.html + executor/summary.html 时使用。典型信号:'改 writer/plan.html 里漏掉的分页参数''补一条原 Spec 没覆盖的需求''修 update 方案里写错的验收标准'、修订既有 writer/plan.html / executor/summary.html、给已有报告递增修订号并补修订历史行(5 列格式与 <ins/<del 标记规则由 html-report 定义,写什么内容、为什么归本 Skill)——只要动的是报告所承载的 Spec 内容,就走本 Skill;请求里出现 report/html 字样不改变归属。只关心报告骨架、样式表、修订标记或 meta/双链格式本身时改用 html-report。默认复用 writer/plan.html 记录的 gitbranch,不新建分支。不要用于新功能从零设计、已合并/已关闭分支上的后续需求,或需要独立…

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files.

It sits in Development, covering Git workflow.

When your agent uses it

  • Tasks that involve Git workflow

Example prompts

  • “改 writer/plan.html 里漏掉的分页参数”
  • “补一条原 Spec 没覆盖的需求”
  • “修 update 方案里写错的验收标准”
  • “/spec-update”

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. 同 Spec 原则:update 报告必须放在原 Spec 目录的 updater/ 下,禁止创建新的 Spec 根目录
  2. 不归档原则:更新完成后不归档,保留在原目录以便后续更新
  3. 编号递增:updater/update-001.html → updater/update-002.html → updater/update-003.html(三位数,不跳号)
  4. 严格遵循方案:只实现 updater/update-xxx.html 定义的修改,不添加方案之外的内容
  5. 回归测试必须通过:新增测试 + 修改测试 + 原有功能回归测试全部通过
  6. 规范维护审查:更新也可能产生长期规则,完成后同样检查是否需要维护 AGENTS.md / .agents/rules/
  7. 同分支原则:update 默认复用原 Spec 的 git_branch,禁止为同一活跃 Spec 的小更新默认创建新分支
  8. 报告用 HTML:update 报告遵循 html-report 契约(HTML + 共享样式表 + data-rev 修订标记);经验/知识记忆保持 Markdown(账本两种格式皆可)
  9. 续接同一批角色:update 是同一个 Spec 的延续,不是新任务。必须续接原来那批角色,不重新 spawn —— 见下文「角色续接」

What it can do on your machine

Read from SKILL.md and the folder at commit a2cccf6. 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:

    • bash
    • 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.

Context cost

Spec Update loads about 1.8k tokens when it runs, and up to ~7.8k if it reads all its reference files. Until then it costs about 137 tokens; SKILL.md has 412 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~137
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.8k

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 412 words (~1,774 tokens).

“用户的期望是「还是那个 writer / tester 在跟我对话」,而不是每次 update 都换一批零历史的新实例。做法固定三步:”

— opening of SKILL.md by HHU3637kr
name
spec-update
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (references) in spec-update of HHU3637kr/skills.

  • SKILL.md
  • references/summary-template.html
  • references/update-template.html

Open the folder on GitHubat commit a2cccf6

Compare with similar skills

Spec Update 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.

Spec Update compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spec Update this skillHHU3637kr/skills145—~1.8kAutomated safety check: PassNone
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Migrate Internal Package into GhostTryGhost/Ghost56k—~3.8kAutomated safety check: PassMIT
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    56k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Writes Conventional Commits whose bodies carry action lines recording the intent, decisions and constraints behind a change, not only what changed.

    29k GitHub starsUsed in 1 repo~2.7k tokens
    DevelopmentAuto-check passed

More from HHU3637kr/skills

All 37 skills in this repo
  • Gif Sticker Maker

    HHU3637kr/skills

    Convert photos (people, pets, objects, logos) into 4 animated GIF stickers with captions.

    145 GitHub starsUsed in 3 repos~1.3k tokens
    Auto-check passed
  • Agent Browser

    HHU3637kr/skills

    Headless browser automation for AI agents using agent-browser CLI.

    145 GitHub stars~1.9k tokensUpdated 16 days ago
    Auto-check passed
  • Darwin Skill

    HHU3637kr/skills

    Darwin Skill (达尔文.skill): autonomous skill optimizer inspired by Karpathy's autoresearch.

    145 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • Token Efficiency

    HHU3637kr/skills

    Cross-platform token audit and optimization for AI coding agents (Cursor, Codex, Claude Code, Hermes, Windsurf, Cline, OpenClaw, Gemini CLI, Aider).

    145 GitHub stars~842 tokensUpdated 16 days ago
    Auto-check passed
  • Guizang Ppt Skill

    HHU3637kr/skills

    生成横向翻页网页 PPT(单 HTML 文件),含 WebGL 背景、章节幕封、数据大字报、图片网格等模板。提供两种风格:① "电子杂志 × 电子墨水"(衬线 + 流体背景 + 暖色) ② "瑞士国际主义"(无衬线 + 网格点阵 + IKB/柠檬黄/柠檬绿/安全橙高亮)。当用户需要制作分享 / 演讲 / 发布会风格的网页 PPT,或提到"杂志风 PPT"、"瑞士风 PPT"、"Swiss…

    145 GitHub starsUsed in 1 repo~4.7k tokens
    Auto-check passed
  • Huashu Nuwa

    HHU3637kr/skills

    女娲造人:输入人名/主题/甚至只是模糊需求,自动深度调研→思维框架提炼→生成可运行的人物Skill. An agent skill from HHU3637kr/skills.

    145 GitHub starsUsed in 1 repo~4k tokens
    Auto-check passed

Categories

Questions about Spec Update

What does Spec Update do?

当同一个活跃 Spec(位于 spec/versions/<version/specs/<spec-dir/)在当前工作分支内需要小迭代、补充需求、修正方案或优化实现,且原 Spec 目录已有 writer/plan.html + executor/summary.html 时使用。典型信号:'改 writer/plan.html 里漏掉的分页参数''补一条原 Spec 没覆盖的需求''修…. Spec Update is an agent skill from HHU3637kr/skills.

When should I use Spec Update?

Spec Update fits situations like: tasks that involve Git workflow.

How do I install Spec Update in Claude Code?

Run `npx skills add HHU3637kr/skills --skill spec-update -a claude-code`. Or copy the skill folder (spec-update in HHU3637kr/skills) into .claude/skills/spec-update in your project. Claude Code loads it when a task matches its description.

How do I install Spec Update in Codex?

Run `npx skills add HHU3637kr/skills --skill spec-update -a codex`. Or copy the skill folder (spec-update in HHU3637kr/skills) into .agents/skills/spec-update in your project. Codex loads it when a task matches its description.

Can I use Spec Update 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 HHU3637kr/skills --skill spec-update -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spec-update, .gemini/skills/spec-update, .github/skills/spec-update and .opencode/skills/spec-update in your project.

What does Spec Update need to run?

Going by SKILL.md and its folder, Spec Update needs the command-line tools its instructions call (bash and git).

Does Spec Update 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 Spec Update 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 Spec Update use?

No licence was found for Spec Update or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Spec Update use?

About 1.8k tokens (SKILL.md is roughly 7.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 6k tokens, read only when the agent opens those files.

What are the alternatives to Spec Update?

Skills that share tags, products or a category with Spec Update: Finishing a Development Branch (obra/superpowers, 297k stars), Code Design Rationale Investigator (cursor/plugins, 10k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars) and Migrate Internal Package into Ghost (TryGhost/Ghost, 56k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spec Update?

HHU3637kr (a GitHub user) maintains it in HHU3637kr/skills, which has 145 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on September 23, 2026.

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