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

workflow-maintainer

GitHub

用于审计和维护agent-workflows库，检查文档漂移、无效链接、缺失文件及元数据一致性。通过运行自动化脚本识别问题并执行修复，确保工作流库的完整性和准确性。

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

Trigger Scenarios

需要审查或验证agent-workflows库的文档和结构时用户要求更新、发布或维护工作流相关的文档和技能包时

Install

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

More Options

Use without installing

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.