managing-timecard

name	Managing Timecard
description	Handle timecard punch-in/out operations using /dakoku command. Use when user executes /dakoku, needs to record work hours, or mentions timecard/勤怠/打刻.
allowed-tools	Bash, 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 への追加を提案

参考リンク

• 詳細仕様: .claude/commands/dakoku.md
• 実装記事: https://izanami.dev/post/5c7c7960-6316-4f44-a645-2dbbeefc3391