日々の業務ログをAIで週報にまとめて数値を照合する

01AIが作成した週報の数値をなぜ照合するのか

AIは短く断片的な業務記録を読みやすい文章に整理するのに役立ちますが、計算結果の基準として扱うべきではありません。週報の文章が自然でも、合計値が変わったり、同じ作業を二重に数えたり、予定中の作業を完了済みとして表現したりする可能性があります。より安全なのは、文章作成と数値照合を分ける方法です。

• 業務ログを事実確認の基準資料として使います。
• AIにはログに書かれている内容だけを要約するよう依頼します。
• 作業時間と件数は構造化データから別に計算します。
• AIの週報と独立して計算した結果を比較します。
• 送信や公開の前に差異があれば修正します。

02小さな合成業務ログから始める

次の業務ログは合成データです。各行には1つの作業、その作業に使った時間、その週のうちに完了したかどうかが記録されています。このように項目を構造化しておくと、後で数値を照合しやすくなります。

手計算では、作業時間は2.0 + 1.5 + 2.5 + 1.0 + 2.0 + 1.5 = 10.5時間です。6件の作業のうち5件がcompletedなので、完了作業数は5件です。最後の作業はまだin progressであり、完了として数えてはいけません。

03記憶ではなくログだけを使って週報を書かせる

業務ログをAIチャットアシスタントに貼り付け、与えたデータだけを整理するよう明確に制限します。後から確認できるように、AIが計算した合計作業時間と完了件数も書かせます。

AIへの依頼例: 下の業務ログだけを使って簡潔な週報を書いてください。完了した業務、進行中の業務、週間合計の3つに分けてください。記録にない成果や作業は追加しないでください。合計記録時間と完了した作業数を明記し、元の作業内容の意味は変えないでください。

一般的なAIの回答は次のようになります。今週は顧客データを整理し、インポートスクリプトを作成してテストし、重複IDを調査し、検証ルールを更新しました。ユーザー向けメモの作成は引き続き進行中です。合計記録時間は10.5時間で、完了した作業は5件です。

04照合用の構造化データを別に保持する

同じ合成例を、date、task、hours、status列を持つwork_log.csvとして保存します。照合スクリプトはAIが書いた文章から数値を取り出すのではなく、この元ファイルを直接読み取ります。

この分離が重要です。CSVは根拠データであり、週報はその根拠を読みやすく表現した成果物です。

05Pythonで作業時間と件数を再計算する

次のPython 3.12スクリプトはwork_log.csvを読み、必須列を確認し、合計作業時間とステータス別件数を計算して、照合結果をoutputs/weekly_reconciliation.txtに保存します。既存のoutputsディレクトリは上書きしません。

from pathlib import Path
import csv

input_path = Path("work_log.csv")
output_dir = Path("outputs")

if output_dir.exists():
    raise SystemExit("outputs already exists; remove or rename it before running again")

if not input_path.exists():
    raise SystemExit("work_log.csv was not found")

required_fields = {"date", "task", "hours", "status"}
rows = []

with input_path.open("r", encoding="utf-8", newline="") as f:
    reader = csv.DictReader(f)

    if reader.fieldnames is None:
        raise SystemExit("CSV has no header")

    missing = required_fields - set(reader.fieldnames)
    if missing:
        raise SystemExit(f"Missing columns: {sorted(missing)}")

    for line_number, row in enumerate(reader, start=2):
        try:
            hours = float(row["hours"])
        except ValueError:
            raise SystemExit(f"Invalid hours value on line {line_number}")

        if hours < 0:
            raise SystemExit(f"Negative hours on line {line_number}")

        status = row["status"].strip().lower()
        if status not in {"completed", "in progress"}:
            raise SystemExit(f"Unexpected status on line {line_number}: {status}")

        rows.append({
            "date": row["date"].strip(),
            "task": row["task"].strip(),
            "hours": hours,
            "status": status,
        })

total_hours = sum(row["hours"] for row in rows)
completed_count = sum(row["status"] == "completed" for row in rows)
in_progress_count = sum(row["status"] == "in progress" for row in rows)

output_dir.mkdir()
report_path = output_dir / "weekly_reconciliation.txt"

report = (
    f"Rows: {len(rows)}\n"
    f"Total hours: {total_hours:.1f}\n"
    f"Completed activities: {completed_count}\n"
    f"In-progress activities: {in_progress_count}\n"
)

report_path.write_text(report, encoding="utf-8")

print(report, end="")
print(f"Saved: {report_path}")

06AIの週報と計算結果を比較する

この例で独立して確認した値は、合計作業時間10.5時間、完了作業5件です。AIの下書きに含まれるすべての数値表現をこれらと比較します。

1. AIの週報に含まれるすべての数値を照合結果と比較します。
2. 完了作業と進行中の作業が混同されていないか確認します。
3. 作業内容を元のログと比較し、AIが成果を追加していないか確認します。
4. AIの合計値とログの計算値が異なる場合は、構造化されたログの計算値を基準に文章を修正します。

07よくあるミスと限界

• 元のログではなく、AIの週報内の数字を足して合計を確認すること。
• 一部の行が進行中でも、すべての行を完了作業として数えること。
• 同じプロジェクトに関する複数のログ行を1件と数えるか複数件と数えるかのルールを決めないこと。
• 記録に明記されていない成果をAIに推測させること。
• ログ内のステータス表現を変更したのに、スクリプトで許可する値を更新しないこと。
• 合計を計算する前に、欠損行、不正な時間値、重複記録を確認しないこと。

この例ではCSVの1行を1つの数えられる作業として扱います。実際の組織では、チケット、成果物、プロジェクト、マイルストーンなどを基準に数える場合があるため、照合前に何を1件と数えるか定義する必要があります。また、このスクリプトで確認できるのは単純な時間合計とステータスだけであり、業務ログ自体が正しいか、業務の品質が十分だったかまでは判断できません。

実行・検証の記録

2026-09-21 · hand-checked example · Python 3.12

• 合成例6行の作業時間が2.0、1.5、2.5、1.0、2.0、1.5であることを手作業で確認しました。
• これらを手計算して合計10.5時間になることを確認しました。
• 5行がcompleted、1行がin progressであることを手作業で確認しました。
• 比較表でも同じ10.5時間と完了作業5件が使われていることを確認しました。
• スクリプトがwork_log.csvを読み、必須列とステータスを検証し、outputs/weekly_reconciliation.txtだけに結果を書き込む構成であることを確認しました。
• スクリプトが既存のoutputsディレクトリを上書きせず停止する構成であることを確認しました。

サイト全体の執筆・検証方針

参考資料

説明と例は独自に作成しました。関連する動作や概念は、以下の公式資料で確認できます。

• Pythonドキュメント: csv — CSVファイルの読み書き ↗ (New tab)
• Pythonドキュメント: pathlib — オブジェクト指向のファイルシステムパス ↗ (New tab)