Antigravity のインラインチャット（Cmd+I）で素早くコードを編集する実践テクニック

// Step 1: コードの任意の位置にカーソルを置く（または範囲を選択）
// Step 2: Cmd+I（Mac）または Ctrl+I（Windows/Linux）を押す
// Step 3: 表示されたテキストボックスに指示を入力
// Step 4: Enter で実行 → AIがコードを生成・修正
 
// 例: 以下の関数にカーソルを置いて Cmd+I → 「エラーハンドリングを追加」
function fetchUser(id: string) {
  const response = await fetch(`/api/users/${id}`);
  return response.json();
}
 
// AIが生成する結果の例:
async function fetchUser(id: string): Promise<User | null> {
  try {
    const response = await fetch(`/api/users/${id}`);
    if (!response.ok) {
      throw new Error(`HTTP error: ${response.status}`);
    }
    return await response.json();
  } catch (error) {
    console.error(`Failed to fetch user ${id}:`, error);
    return null;
  }
}

// ❌ カーソルだけ置いて「型を追加」と指示 → 周辺のどの部分か曖昧
// ✅ 関数全体を選択して「引数と戻り値に型を追加」→ 確実に正しい箇所を修正
 
// 選択範囲の例: 以下の関数全体を選択してから Cmd+I
function processOrder(order, user) {
  const total = order.items.reduce((sum, item) => sum + item.price, 0);
  const discount = user.isPremium ? total * 0.1 : 0;
  return { total: total - discount, discount };
}
 
// 期待する出力:
interface OrderItem {
  name: string;
  price: number;
  quantity: number;
}
 
interface Order {
  items: OrderItem[];
}
 
interface User {
  isPremium: boolean;
}
 
interface OrderResult {
  total: number;
  discount: number;
}
 
function processOrder(order: Order, user: User): OrderResult {
  const total = order.items.reduce((sum, item) => sum + item.price, 0);
  const discount = user.isPremium ? total * 0.1 : 0;
  return { total: total - discount, discount };
}

# ❌ 曖昧な指示
「この関数を改善して」
「もっと良くして」
「バグを直して」
 
# ✅ 具体的な指示
「null チェックを追加して、id が undefined の場合は早期リターンする」
「forEach を map に変換して、結果を新しい配列として返す」
「async/await パターンに書き換えて、try-catch でエラーをログ出力する」
「この関数を pure function にリファクタリングして、副作用を取り除く」

// Step 1: まず基本構造を生成
// Cmd+I → 「ユーザー認証のミドルウェア関数を作成」
 
export function authMiddleware(req, res, next) {
  const token = req.headers.authorization;
  if (!token) return res.status(401).json({ error: 'Unauthorized' });
  next();
}
 
// Step 2: 型を追加
// 関数全体を選択 → Cmd+I → 「Express の型を追加して」
 
import { Request, Response, NextFunction } from 'express';
 
export function authMiddleware(
  req: Request,
  res: Response,
  next: NextFunction
): void {
  const token = req.headers.authorization;
  if (!token) {
    res.status(401).json({ error: 'Unauthorized' });
    return;
  }
  next();
}
 
// Step 3: JWT検証ロジックを追加
// 関数本体を選択 → Cmd+I → 「JWT トークンを検証して、デコードしたペイロードを req.user にセット」

// 元の関数を選択して Cmd+I → 「Jest でこの関数のテストを書いて。正常系と異常系を含めて」
 
// 元のコード:
function calculateShipping(weight: number, distance: number): number {
  if (weight <= 0 || distance <= 0) throw new Error('Invalid input');
  const baseRate = 500;
  const weightRate = weight * 10;
  const distanceRate = distance * 2;
  return baseRate + weightRate + distanceRate;
}
 
// AI が生成するテスト:
describe('calculateShipping', () => {
  test('正常な入力で送料を計算する', () => {
    expect(calculateShipping(5, 100)).toBe(500 + 50 + 200);
  });
 
  test('重量が0以下の場合にエラーを投げる', () => {
    expect(() => calculateShipping(0, 100)).toThrow('Invalid input');
  });
 
  test('距離が0以下の場合にエラーを投げる', () => {
    expect(() => calculateShipping(5, 0)).toThrow('Invalid input');
  });
 
  test('重量と距離が大きい場合も正しく計算する', () => {
    expect(calculateShipping(100, 500)).toBe(500 + 1000 + 1000);
  });
});

// 以下のコメントを選択して Cmd+I → 「このコメントの内容を実装して」
 
// レート制限ミドルウェア:
// - 1分あたり60リクエストまで
// - IPアドレスベースで制限
// - 制限超過時は 429 ステータスを返す
// - X-RateLimit-Remaining ヘッダーを付与

# Cmd+I に入力する内容の例:
「以下のエラーを修正して: TypeError: Cannot read property 'map' of undefined」

// ファイル全体（または複数の関数）を選択 → Cmd+I
// → 「すべての public 関数に JSDoc コメントを追加して。
//    @param と @returns を含めて」