change-propose

change-propose is a skill for Claude Code, Codex from lupingluke-ai/general-ai-spec. It costs 60 tokens per session (5,540 once invoked), scanned A, original, MIT.

A workflow for turning an approved product requirements document into a proposed software change with specifications, design notes, tasks, and draft pull requests. A pull request is a reviewable set of proposed code or documentation changes.

In plain words
What is it for?
Use it to scan the backlog or select a backlog item, validate its approved requirements, create the four planning documents, open a feature branch and draft pull request, and update the main indexes.
Why use it?
It checks that the requirements document and dependencies are ready before work is proposed, then keeps the proposal and project indexes organized through reviewable branches and pull requests.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions Claude Code; mentions Codex.

Good fit Use it to scan the backlog or select a backlog item, validate its approved requirements, create the four planning documents, open a feature branch and draft pull request, and update the main indexes.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/lupingluke-ai/general-ai-spec/change-propose
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add lupingluke-ai/general-ai-spec --skill change-propose
Clone the repo
git clone --depth 1 https://github.com/lupingluke-ai/general-ai-spec

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for change-propose

README.md
[![agentmods](https://agentmods.dev/badge/skills/lupingluke-ai/general-ai-spec/change-propose/github.svg)](https://agentmods.dev/skills/lupingluke-ai/general-ai-spec/change-propose)
Your own site
<a href="https://agentmods.dev/skills/lupingluke-ai/general-ai-spec/change-propose"><img src="https://agentmods.dev/badge/skills/lupingluke-ai/general-ai-spec/change-propose/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for change-propose

Your own site · 80×15
<a href="https://agentmods.dev/skills/lupingluke-ai/general-ai-spec/change-propose"><img src="https://agentmods.dev/badge/skills/lupingluke-ai/general-ai-spec/change-propose.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 60 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,540 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00060 $0.05540
Opus 5 $0.00030 $0.02770
Sonnet 5 $0.00012 $0.01108
Haiku 4.5 $0.00006 $0.00554

Measured 11d ago against content hash 32a56db9bbb4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

change-propose scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/change-propose/SKILL.md · 415 lines

How it starts

The opening of the file, as written. The whole thing — 415 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Change Propose

Overview

从 approved PRD 出发,生成四件套(proposal + delta specs + design + tasks),创建 feature branch 和 Draft PR,并通过 governance PR 更新 main 索引。

职责边界: 只负责 propose 阶段。执行由 change-dispatch,审查/归档由 change-review 各自独立完成。

Announce at start: "Running change-propose: looking for changes to propose."

Bash 命令规范

  1. 每条命令独立调用 — 不用 &&||; 串联
  2. 管道可以用 — 如 git branch -r | grep feat/
  3. 并行无依赖时分开调用 — 多个独立 Bash tool call

PRD YAML 前置条件

---
id: PRD-NNN
type: feature | bug | chore | hotfix
backlog-ref: B-NNN
module-ref: M-NNN                 # 必填;归属模块
status: approved
created: YYYY-MM-DD
depends-on: [B-xxx, B-yyy]        # 前置 backlog 依赖,无则 []
change-id: kebab-case-name        # 预定义 change-id,按类型携带前缀
design-inputs:                    # 必填;至少包含模块文档路径
  - design/modules/M-NNN-<slug>.md
  # - design/inputs/...(可选追加)
---

自动扫描时,缺少 typedepends-onchange-idmodule-refdesign-inputs 的 PRD 会被跳过;显式 /change-propose B-NNN 命中这些问题时 STOP 并写日志。design-inputs 必须包含一条指向 design/modules/<M-NNN>-*.md 的路径,否则视为缺失。

类型 → 分支/提交前缀映射规则

backlog / PRD 的 type 是声明事实源;change-id 的命名前缀由 prd-writer 按 type 生成(feature 无前缀 / bug fix- / chore chore- / hotfix hotfix-),本 skill 只做一致性校验。由 type 映射 branch / commit / PR 前缀:

type branch 前缀 commit type PR 标题前缀
feature feat/ feat feat
bug fix/ fix fix
chore chore/ chore chore
hotfix hotfix/ fix fix

Phase 0 必须验证:backlog type = PRD type,且 change-id 命名前缀与 type 匹配(type=bug 必须 fix- 开头、type=feature 不得携带 fix-/chore-/hotfix- 前缀等)。验证通过后,映射结果在 Phase 1/2 全程复用,禁止重新计算或硬编码 feat/4 种类型走完全相同的执行路径,前缀差异仅用于语义标签(git log / release notes 过滤)。


Phase 0 — 目标选定

有参数(/change-propose B-045

直接定位 product/backlog.md 中的 B-045 条目,读取对应 PRD。

无参数(/change-propose

扫描 product/backlog.md,筛选满足全部条件的条目:

  1. 阶段为 exploring
  2. 有 PRD 列值且 PRD 文件存在
  3. PRD status: approved
  4. PRD 有 typechange-iddepends-onmodule-refdesign-inputs 字段
  5. design-inputs 至少包含一条指向 design/modules/<module-ref>-*.md 的路径,且该文件存在
  6. backlog type = PRD type,且 change-id 命名前缀与 type 匹配(prd-writer 生成规则)
  7. depends-on 中所有依赖条目阶段为 done
  8. <branch-prefix>/<change-id> 远程分支不存在,或远程分支已存在但 backlog 仍停留在 exploring(发布恢复模式)

Read the full file on GitHub · 415 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 415 lines · 60 tokens per session scan A 32a56db9bbb4

Subscribe to this mod's changes

change-propose is a skill published in the GitHub repository lupingluke-ai/general-ai-spec (5 stars, last pushed 1mo ago), licensed MIT. It adds 60 tokens to every session and 5,540 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.