Agent Skills › franklioxygen/agent-workflows › workflow-maintainer

workflow-maintainer

GitHub

用于审计和维护agent-workflows库，检测文档漂移、失效链接、缺失文件及元数据错误。执行自动化脚本并依据清单修复问题，确保工作流文档与代码的一致性。

skills/workflow-maintainer/SKILL.md franklioxygen/agent-workflows

触发场景

需要审查或验证agent-workflows库的文档和配置发现文档链接失效、元数据过时或缺失必要文件发布前进行一致性检查和合规性审计

安装

npx skills add franklioxygen/agent-workflows --skill workflow-maintainer -g -y

更多选项

不安装直接使用

npx skills use franklioxygen/agent-workflows@workflow-maintainer

指定 Agent (Claude Code)

npx skills add franklioxygen/agent-workflows --skill workflow-maintainer -a claude-code -g -y

安装 repo 全部 skill

npx skills add franklioxygen/agent-workflows --all -g -y

预览 repo 内 skill

npx skills add franklioxygen/agent-workflows --list

SKILL.md

Frontmatter

{
    "name": "workflow-maintainer",
    "description": "Audit and maintain the agent-workflows library for documentation drift, broken Markdown links, missing required workflow files, stale README inventories, invalid skill metadata, and automation-script inconsistencies. Use when Codex is asked to review, validate, update, or release changes to agent-workflows docs or bundled skills."
}

Workflow Maintainer

Quick Start

Locate the library root. The audit script auto-checks AGENT_WORKFLOWS_ROOT, script-relative paths, and the current workspace.
Run scripts/audit_workflow_library.py from this skill directory, or by absolute path.
Read references/audit-checklist.md before making maintenance edits.
Follow shared safety, validation, and scope rules in ../_shared/references/skill-operating-rules.md.
Fix only the reported drift or the user-requested maintenance scope. Do not rewrite workflow content unless the issue requires it.
Re-run the audit script and any affected helper scripts before final handoff.

Maintenance Rules

Preserve the library's separation of concerns: workflow-specific guidance stays in workflow files; repeated safety, preflight, and conventions stay in shared/; skill-specific routing stays in the relevant skill.
When workflow names, filenames, or shared docs change, update all references together: README.md, skills/workflow-automation/references/library-loading.md, skills/workflow-automation/references/workflow-routing.md, and related scripts.
Treat broken links, missing required files, stale skill metadata, and invalid manifests as blocking issues.
Treat style-only edits, wording improvements, and optional examples as non-blocking unless the user asked for them.
Never commit or push without explicit permission.

Audit Workflow

Run the audit script:

python3 scripts/audit_workflow_library.py

If the script reports errors, inspect only the affected files first.
If the issue concerns judgment rather than deterministic validation, use the checklist reference.
Apply narrow fixes.
Re-run:

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

Report findings fixed, commands run, remaining warnings, and whether any validation was skipped.

When to Read the Checklist

Read references/audit-checklist.md when the user asks for a human review of the library, release readiness, docs consistency, routing changes, or when the script reports no errors but the change may still have workflow-design risk.