SuperAPI AI 工具集

skills-readme-alignment-maintainer

写作与研究

查看项目

更新于 10-15 21:49

技能介绍

用途:对工作区中的 *-skills 仓库执行确定性的 README 标准维护,先审计后可选修复。

主要能力:两阶段工作流,第一阶段用 scripts/readme_alignment_maintainer.py 审计,查看 profile 分配与问题分类;第二阶段加 --apply-fixes 做有界修复并复查受影响的仓库。输出 Markdown 摘要(运行上下文、profile 分配、问题、修复、剩余问题、错误)与 JSON 报告(run_context、repos_scanned、profile_assignments、schema_violations、command_integrity_issues、fixes_applied、post_fix_status、errors)。JSON 供自动化集成,Markdown 供人工复核。

输入参数:--workspace <path>、--repo-glob <pattern>(默认 *-skills)、--exclude <path>(可重复)、可选 --apply-fixes、可选 --md-out、--json-out。

命令示例:仅审计 uv run python scripts/readme_alignment_maintainer.py --workspace ~/Workspace --repo-glob '*-skills' --print-md --print-json;审计加有界修复加 --apply-fixes --md-out /tmp/readme-alignment-report.md --json-out /tmp/readme-alignment-report.json;有未解决问题时报错可加 --fail-on-issues。

Profile 模型:公开精选仓库强制完整 schema,含 ## Customization Workflow Matrix、## Install individually by Skill or Skill Pack、## Update Skills、包裹式可发现性章节(## More resources for similar Skills 及必需的嵌套 ### 子节)和 ## Keywords;私有/内部仓库保持简洁,省略仅增长用途的章节;bootstrap 仓库允许以最小完整结构创建初始 README。

安全规则:绝不自动提交;仅编辑 README 文件;绝不编辑源代码、清单、锁文件、CI 文件或 AGENTS.md;仅做有界的标题/schema/可发现性插入与 bootstrap README 创建;保持最小 diff 并尽量保留原有风格。

适用场景:在 Codex 自动化提示中通过 $skills-readme-alignment-maintainer 调用,配合 references/automation-prompts.md 模板使用。参考文献涵盖 profile 映射、按 profile 的必需章节、语气风格规则、可发现性要求、验证清单、种子标准工件与自动化提示模板。

限制:官方未提供收费、价格或平台相关说明。