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

om-fix-specs

GitHub

将遗留的SPEC-*规范文件重命名为日期+slug格式，处理文件名冲突并更新引用链接。

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

Trigger Scenarios

遗留SPEC-*文件名需清理移除前缀后出现文件名冲突规范化后链接失效

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.