managing-timecard

Handle timecard punch-in/out operations using /dakoku command. Use when user executes /dakoku, needs to record work hours, or mentions timecard/勤怠/打刻.

⭐2stars🔀0forks📁View on GitHub🕐Updated Nov 4, 2025⬇️1downloads

When & Why to Use This Skill

The Managing Timecard skill for Claude streamlines employee attendance tracking and work hour management through the specialized /dakoku command. It allows users to record punch-in/out times, manage breaks, and generate monthly reports directly within the chat interface. By automating the logging of work hours into structured Markdown and JSON formats, it ensures accurate record-keeping for payroll and compliance, making it an essential tool for freelancers and remote teams.

Use Cases

  • Daily Attendance Tracking: Quickly record work start and end times using '/dakoku in' and '/dakoku out' to maintain an accurate daily log.
  • Break and Interval Management: Use the '/dakoku break' command to track rest periods, ensuring that net working hours are calculated correctly for labor law compliance.
  • Monthly Work Summaries: Generate comprehensive attendance reports for specific months to simplify the process of invoice generation or payroll submission.
  • Automated Data Archiving: Automatically organize and store timecard data in a structured directory format (YYYY/MM) for long-term storage and easy retrieval in both human-readable and machine-readable formats.
nameManaging Timecard
descriptionHandle timecard punch-in/out operations using /dakoku command. Use when user executes /dakoku, needs to record work hours, or mentions timecard/勤怠/打刻.
allowed-toolsBash, Read, Write, Edit

Managing Timecard

/dakoku コマンドによる勤怠打刻機能を管理するスキル。

いつ使うか

  • ユーザーが /dakoku in | out | break | list | month を実行した時
  • 勤怠記録の参照・管理が必要な時
  • 勤怠、打刻、タイムカードに関する質問があった時

日時取得の優先順位

  1. 第一優先: TIME MCP Server を使用
  2. 第二優先: ユーザー環境の now エイリアス(date "+%Y-%m-%d %H:%M:%S")
  3. 最終手段: date コマンドでローカル時刻を取得

実行手順

1. コマンド仕様の確認

詳細は .claude/commands/dakoku.md を参照すること。

2. 保存処理

  • パス: _docs/timecard/YYYY/MM/
  • 形式: Markdown と JSON の 2 形式で保存
  • ディレクトリが存在しない場合は自動作成

3. エラーハンドリング

  • TIME MCP Server が利用できない場合は、必ずフォールバック処理を実行
  • now エイリアスが未設定の場合は、.zshrc への追加を提案

参考リンク