Agent Skills
› franklioxygen/agent-workflows
› workflow-maintainer
workflow-maintainer
GitHub用于审计和维护 agent-workflows 库，检测文档漂移、断裂链接、缺失文件及无效元数据。当需要审查、验证或更新工作流文档与技能时触发。遵循安全规则，仅修复报告问题，不擅自重写内容，确保库的一致性与完整性。
Trigger Scenarios
审查 agent-workflows 文档一致性
验证工作流发布准备情况
修复断裂的 Markdown 链接
更新过时的 README 索引
检查技能元数据有效性
Install
npx skills add franklioxygen/agent-workflows --skill workflow-maintainer -g -y
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.pyfrom 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.
Version History
- 063f52c Current 2026-07-05 20:15
