workflow-maintainer

name	workflow-maintainer
description	审计并维护 agent-workflows 库，检查文档漂移、Markdown 链接损坏、必需工作流文件缺失、README 清单过期、技能元数据无效，以及自动化脚本与文档不一致等问题；当 Codex 被要求审查、验证、更新或发布 agent-workflows 文档及内置技能时使用。

工作流维护者

快速开始

• 定位库根目录。审计脚本会自动检查 AGENT_WORKFLOWS_ROOT、脚本相对路径以及当前工作区。
• 在此技能目录中运行 scripts/audit_workflow_library.py，或使用绝对路径运行。
• 在进行维护编辑前，先阅读 references/audit-checklist.md。
• 遵循 ../_shared/references/skill-operating-rules.md 中共享的安全、验证和范围规则。
• 只修复报告出的漂移问题，或用户明确指定的维护范围。除非问题确实要求，否则不要重写工作流内容。
• 最终交付前重新运行审计脚本和所有受影响的辅助脚本。

维护规则

• 保持库的职责分离：工作流专属指导留在工作流文件中；重复的安全规则、预检和约定留在 shared/ 中；技能专属路由规则留在相应技能里。
• 当工作流名称、文件名或共享文档发生变化时，要一起更新所有引用：README.md、skills/workflow-automation/references/library-loading.md、skills/workflow-automation/references/workflow-routing.md 以及相关脚本。
• 将损坏链接、必需文件缺失、过期的技能元数据和无效清单视为阻塞问题。
• 将纯样式改动、措辞优化和可选示例视为非阻塞，除非用户明确要求它们。
• 未经明确许可，绝不要提交或推送。

审计工作流

1. 运行审计脚本：

python3 scripts/audit_workflow_library.py

2. 如果脚本报告错误，先只检查受影响的文件。
3. 如果问题涉及人工判断，而不是确定性校验，参考清单文档。
4. 应用范围收窄的修复。
5. 重新运行：

python3 scripts/audit_workflow_library.py
python3 skills/workflow-automation/scripts/find_workflow_library.py --json

6. 报告已修复的问题、运行过的命令、剩余警告，以及是否跳过了任何验证。

何时阅读清单

当用户要求对该库进行人工评审、发布就绪性检查、文档一致性检查、路由变更检查，或脚本未报错但改动仍可能带来工作流设计风险时，阅读 references/audit-checklist.md。