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

遗留规格文件使用 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.