Agent Skills
› franklioxygen/agent-workflows
› workflow-maintainer
workflow-maintainer
GitHub用于审计和维护agent-workflows库，检查文档漂移、链接损坏及元数据有效性。通过运行脚本识别问题并修复，确保工作流与文档一致，仅在用户明确要求或阻塞时处理非样式问题。
Trigger Scenarios
审查或验证agent-workflows文档及内置技能
更新或发布工作流库
执行发布就绪性检查
检测文档一致性或路由变更风险
Install
npx skills add franklioxygen/agent-workflows --skill workflow-maintainer -g -y
SKILL.md
Frontmatter
{
"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以及相关脚本。 - 将损坏链接、必需文件缺失、过期的技能元数据和无效清单视为阻塞问题。
- 将纯样式改动、措辞优化和可选示例视为非阻塞，除非用户明确要求它们。
- 未经明确许可，绝不要提交或推送。
审计工作流
- 运行审计脚本：
python3 scripts/audit_workflow_library.py
- 如果脚本报告错误，先只检查受影响的文件。
- 如果问题涉及人工判断，而不是确定性校验，参考清单文档。
- 应用范围收窄的修复。
- 重新运行：
python3 scripts/audit_workflow_library.py
python3 skills/workflow-automation/scripts/find_workflow_library.py --json
- 报告已修复的问题、运行过的命令、剩余警告，以及是否跳过了任何验证。
何时阅读清单
当用户要求对该库进行人工评审、发布就绪性检查、文档一致性检查、路由变更检查，或脚本未报错但改动仍可能带来工作流设计风险时，阅读 references/audit-checklist.md。
Version History
- 063f52c Current 2026-07-05 20:15
