AgentSkillsCN

workflow-logger

为多智能体设计工作流提供结构化的Markdown日志记录。将格式化后的事件以时间戳、阶段信息以及智能体活动记录至workflow_log.md。在记录工作流进展、阶段转换、批评意见或最终总结时使用此功能。

SKILL.md
--- frontmatter
name: workflow-logger
description: Structured markdown logging for multi-agent design workflows. Appends formatted events to workflow_log.md with timestamps, phase info, and agent activity. Use when recording workflow progress, phase transitions, Critic verdicts, or final summaries.

Workflow Logger

When to use

  • •At workflow start (create log with header)
  • •At each phase transition
  • •After each agent completes work
  • •After each Critic verdict
  • •At workflow completion (final summary)

How to use

Initialize log

bash
python3 .github/skills/workflow-logger/scripts/workflow-logger.py init --folder generated_docs_[TIMESTAMP] --project "Project Name"

Log phase start

bash
python3 .github/skills/workflow-logger/scripts/workflow-logger.py phase --folder generated_docs_[TIMESTAMP] --phase "Phase 1: Research" --agents "Researcher x3"

Log event

bash
python3 .github/skills/workflow-logger/scripts/workflow-logger.py event --folder generated_docs_[TIMESTAMP] --message "Research complete. 3 files created."

Log Critic verdict

bash
python3 .github/skills/workflow-logger/scripts/workflow-logger.py verdict --folder generated_docs_[TIMESTAMP] --iteration 2 --verdict CONDITIONAL --critical 0 --major 2 --minor 1 --issues '[{"severity":"MAJOR","section":"4","issue":"Specific instance nodes in diagram","action":"Replace with abstract fleet node"},{"severity":"MINOR","section":"5","issue":"Mindmap exceeds 10 elements","action":"Consolidate items"}]'

If issues JSON is not available, fall back to summary:

bash
python3 .github/skills/workflow-logger/scripts/workflow-logger.py verdict --folder generated_docs_[TIMESTAMP] --iteration 2 --verdict CONDITIONAL --critical 0 --major 2 --minor 1 --summary "Diagram issues and missing monitoring details"

Log completion

bash
python3 .github/skills/workflow-logger/scripts/workflow-logger.py complete --folder generated_docs_[TIMESTAMP] --iterations 3

Output format

The script appends formatted markdown to workflow_log.md:

markdown
# Workflow Execution Log
Project: Fish TTS Autoscaling
Started: 2026-02-10 17:28:21
Status: In Progress

## Execution Timeline

### [2026-02-10 17:28:21] Phase 1: Research
- Activated: Researcher x3
- Status: In progress

### [2026-02-10 17:30:45] Review - Iteration 2/5
- Verdict: CONDITIONAL
- Critical: 0, Major: 2, Minor: 1
- Key feedback: Diagram issues and missing monitoring details

## Final Summary
- Status: COMPLETED
- Total iterations: 3
- Completion time: 2026-02-10 17:42:15
- Processing time: 13m 54s
- Documents approved: YES
- Next steps: Invoke DevOps agent with 'deploy' command