logging-implementation

Manage implementation logs in _docs/templates/ with consistent format. Use when starting project work, completing implementations, or when user mentions 実装ログ/implementation log.

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

When & Why to Use This Skill

This Claude skill automates the creation and management of standardized implementation logs to ensure consistent project documentation. By enforcing a unified format for recording design intent, side effects, and technical details, it enhances traceability and helps developers maintain a clear history of architectural decisions throughout the software development lifecycle.

Use Cases

  • Task Initialization: Automatically set up a new implementation log when starting a project feature to track progress from day one.
  • Post-Implementation Documentation: Generate structured logs upon completion of a task, capturing critical details like design rationale and potential side effects for future reference.
  • Knowledge Retrieval: Quickly access and review past implementation history to understand the context of previous code changes and avoid redundant work.
  • Standardized Reporting: Ensure all team members follow the same logging conventions, making it easier for project managers and new developers to audit project evolution.
nameLogging Implementation
descriptionManage implementation logs in _docs/templates/ with consistent format. Use when starting project work, completing implementations, or when user mentions 実装ログ/implementation log.
allowed-toolsRead, Write, Edit, Bash

Logging Implementation

プロジェクト全体で一貫した実装ログ管理を行うスキル。

いつ使うか

  • プロジェクトでの実装作業開始時
  • 実装が完了した時
  • 過去の実装履歴を参照する必要がある時
  • ユーザーが「実装ログ」について言及した時

プロジェクト起動時の処理

  1. _docs/templates/ が存在するか確認
  2. 存在しない場合は _docs/templates/ を作成
  3. _docs/ 配下を全てコンテキストとして読み込み
  4. 前回の設計意図や副作用を踏まえた上で提案

実装完了時の処理

1. 日時取得

  • TIME MCP Server を優先
  • 利用不可の場合は now エイリアス(date "+%Y-%m-%d %H:%M:%S")
  • エイリアス未設定の場合は .zshrc 等に追加提案

2. ログファイル作成

  • ファイル名形式: yyyy-mm-dd_機能名.md
  • 命名規則: 複数単語の場合はケバブケース(例:2025-10-19_product-name.md)
  • 保存先: _docs/templates/

3. ログテンプレート

機能名: <ここに機能名>

- 日付: yyyy-mm-dd HH:MM:SS
- 概要: <実装の目的・背景>
- 実装内容: <主な実装内容>
- 設計意図: <なぜこの設計にしたのか>
- 副作用: <懸念事項があれば明記>
- 関連ファイル: <ファイルの場所>

必須項目

実装ログには以下を必ず含めること:

  • 実装の目的・背景
  • 主な実装内容
  • 設計意図
  • 副作用
  • 関連ファイル

重要な注意事項

  • 実装ログは必ず必ず必ず残すこと
  • 過去の実装ログを参照し、矛盾や重複を避けること
  • 日時を正確に取得し、西暦-日付-時間で必ず記載すること(例:日付: 2100-01-01 11:11:11)