Agent Skills › open-mercato/open-mercato › om-fix-specs

om-fix-specs

GitHub

用于规范化 .ai/specs 目录下的旧版规格文件名，将其转换为日期+slug格式，并自动处理文件重命名、链接更新及冲突解决。

.ai/skills/om-fix-specs/SKILL.md open-mercato/open-mercato

Trigger Scenarios

清理 legacy SPEC-* 或 SPEC-ENT-* 前缀的文件名修复因移除数字前缀导致的文件名冲突更新因文件名标准化而失效的引用链接

Install

npx skills add open-mercato/open-mercato --skill om-fix-specs -g -y

More Options

Non-standard path

npx skills add https://github.com/open-mercato/open-mercato/tree/main/.ai/skills/om-fix-specs -g -y

Use without installing

npx skills use open-mercato/open-mercato@om-fix-specs

指定 Agent (Claude Code)

npx skills add open-mercato/open-mercato --skill om-fix-specs -a claude-code -g -y

安装 repo 全部 skill

npx skills add open-mercato/open-mercato --all -g -y

预览 repo 内 skill

npx skills add open-mercato/open-mercato --list

SKILL.md

Frontmatter

{
    "name": "om-fix-specs",
    "description": "Normalize spec filenames in .ai\/specs and .ai\/specs\/enterprise to the date+slug convention. Use this when legacy `SPEC-*` \/ `SPEC-ENT-*` names need to be cleaned up, when filename collisions appear after dropping numeric prefixes, or when links must be updated after normalization."
}

Fix Specs

Normalize legacy spec filenames to the date+slug convention with minimal churn.

When to use

Legacy specs still use SPEC-* or SPEC-ENT-* filename prefixes.
Two specs would collide after removing the numeric prefix.
Links now point to the wrong filename after normalization.

Rules

New canonical filenames are {YYYY-MM-DD}-{slug}.md for both OSS and enterprise specs.
Remove legacy SPEC-* / SPEC-ENT-* filename prefixes instead of inventing replacement numbers.
If two files would normalize to the same target, keep the older filename target and make the newer slug more specific.
Update filename references and links everywhere in the repo.
Preserve document history inside the file content when useful, but filenames MUST follow the date+slug format.

Workflow

Run a dry run first: python3 .ai/skills/om-fix-specs/scripts/fix_spec_conflicts.py --dry-run
Review planned renames and file updates.
Apply changes: python3 .ai/skills/om-fix-specs/scripts/fix_spec_conflicts.py --apply
Verify no conflicts remain: python3 .ai/skills/om-fix-specs/scripts/fix_spec_conflicts.py --dry-run

Notes

The script scans both .ai/specs and ai/specs roots if present.
Enterprise typos are tolerated (enterprise and enterpirse).
Conflict resolution drops legacy numeric prefixes first, then adds a slug suffix only when two files would land on the same target filename.
Files without an embedded YYYY-MM-DD segment are skipped by the script and must be normalized manually.
Review in-file titles manually after normalization if you also want to remove legacy SPEC-* labels from headings.