用途:面向普通软件项目的 README.md 维护,通过确定性的审计与受限应用模式,让项目 README 的结构与内容更清晰一致。
输入参数:必填 --project-root <path> 与 --run-mode <check-only|apply>;可选 --readme-path <path>。
工作流程:先校验项目根目录并解析目标 README.md;依据包元数据、CLI 入口、应用或服务清单、工作区文件等仓库信号识别仓库画像。check-only 模式下审计标题与价值主张、常见 README 章节、必需的 Overview > Motivation 结构以及命令完整性;apply 模式下将修改限制在目标 README.md 内,修复缺失结构与有依据的措辞,随后重新运行同一审计确认修复后状态。若仓库是使用专门安装与可发现性约定的 skills 或插件仓库,应改用 /Users/galew/Workspace/agent-plugin-skills 下的 maintain-skills-readme 技能。
输出契约:返回 Markdown 与 JSON,包含 run_context、profile_assignment、schema_violations、command_integrity_issues、content_quality_issues、fixes_applied、post_fix_status、errors。若无问题且无错误,输出恰为 No findings。
限制与护栏:绝不自动提交、自动推送或创建 PR;绝不编造仓库中无依据的命令、安装步骤或支持声明;除目标 README.md 外不编辑任何文件;不适用于 agent-skills、Codex 插件、Claude 插件或类似 skills/插件仓库。
参考文件:agents/openai.yaml、references/section-schema.md、references/profile-model.md、references/output-contract.md、references/fix-policies.md、references/style-rules.md、references/verification-checklist.md、references/project-readme-maintenance-automation-prompts.md。安装命令、价格与平台支持等信息暂未提供。