dev-reports

mpazaryna 的头像作者 mpazaryna

用于工作文档和沟通的开发者报告技能。在撰写日志、开发日志、状态更新(22A/22B)、进度报告或记录开发工作时使用。从git历史记录或手动输入生成报告。

📖 中文导读:用于工作文档和沟通的开发者报告技能。在撰写日志、开发日志、状态更新(22A/22B)、进度报告或记录开发工作时使用。从git历史记录或手动输入生成报告。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: dev-reports description: Developer reporting skill for work documentation and communication. Use when writing journals, devlogs, status updates (22A/22B), progress reports, or documenting development work. Generates reports from git history or manual input.

Dev Reports

Document and communicate development work. From git commits to polished reports.

Report Types

This skill supports multiple report formats:

Type When to Use Trigger Phrases
Git Journal Summarize work from commits "journal this", "journal today's work"
Devlog Narrative work documentation "devlog", "write a devlog"
Status (22A) Full Progress/Plans/Problems "22A", "PPP update", "full status"
Status (22B) Condensed status update "22B", "quick status"

How to Use This Skill

  1. Identify the report type from the request
  2. Load the appropriate template from examples/:
    • Git journal → Read examples/github-journal.md
    • Devlog → Read examples/devlog.md
    • Status (full) → Read examples/form-22a.md
    • Status (condensed) → Read examples/form-22b.md
  3. Follow the workflow in that template
  4. Generate the report in the specified format

Quick Reference

Request Template
"Journal this", "journal the last 4 hours" examples/github-journal.md
"Write a devlog", "devlog update" examples/devlog.md
"22A", "PPP update", "progress report" examples/form-22a.md
"22B", "quick status" examples/form-22b.md

Report Purposes

Git Journal

Generates structured journal entries from git commit history. Great for:

  • End of day summaries
  • Sprint retrospectives
  • Documenting refactors or features

Devlog

Narrative-style work logs with context and decisions. Great for:

  • Explaining technical decisions
  • Sharing learnings with the team
  • Building institutional knowledge

Status Updates (22A/22B)

Structured Progress/Plans/Problems format. Great for:

  • Team standups
  • Leadership updates
  • Weekly reports

Part of the dev-* Family

Skill Purpose
dev-inquiry Technical investigation and decision-making
dev-reason Problem-solving and debugging (future)
dev-reports Work documentation and communication