# Managing Timecard

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

- Skill: `majiayu000/managing-timecard` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/managing-timecard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/managing-timecard/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/managing-timecard

---


# 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