Nocodb Guide

🚨🚨🚨 最重要：カラムオプション更新時の注意（絶対厳守）

⚠️ SingleSelect/MultiSelectカラムのオプション更新は既存データを破壊する可能性がある

禁止事項

# ❌ 絶対禁止：新しいオプションで上書き
mcp__nocodb__nocodb_update_column with new options array
# → 既存レコードの値が全てnullになる

安全な更新手順

1. 事前バックアップ（必須）

   ./tools/nocodb/cli.sh list {テーブル} 500 > /tmp/backup_YYYYMMDD.json
   

2. Airtableとの同期確認

   • Airtableに同じデータがあることを確認
   • 復旧用データソースとして使用可能

3. オプション追加のみ（推奨）

   • NocoDB UIから手動で絵文字・色を変更
   • 既存オプションのタイトル変更は安全

復旧手順（データが消えた場合）

# 1. Airtableからデータ取得
mcp__airtable__list_records

# 2. マッピング付きで復旧スクリプト生成
python3 generate_restore_script.py

# 3. バッチ更新実行
zsh /tmp/restore_status.sh

🚨 必須ルール

0. 工数の定義

1人日 = 7時間（8時間労働 - 休憩1時間）

工数見積もりの優先順位:

1. NocoDBの「見積もり（人日）」フィールドに値があればそれを使用
2. 値がなければ以下の基準で推定：
   • 単一ファイル・UIのみ → 0.5人日
   • 複数ファイル・ロジック追加 → 1〜2人日
   • システム全体・新機能 → 3〜5人日

1. レポートのファイル保存（最重要）

生成したレポートは必ずファイルに保存すること。

保存先: docs/reports/YYYY-MM-DD-{レポート種別}.md

ファイル命名規則:

例:

docs/reports/2026-01-12-requirements-priority-report.md
docs/reports/2026-01-12-bugs-priority-report.md

1. URL必須表示

すべてのレコードIDには必ずNocoDBへの直接リンクを付与する。

URLフォーマット: