feat: implement Claude Code GitHub Action v1.0 with auto-detection and slash commands

action.yml

@@ -1,5 +1,5 @@
-name: "Claude Code Action Official"
-description: "General-purpose Claude agent for GitHub PRs and issues. Can answer questions and implement code changes."
+name: "Claude Code Action v1.0"
+description: "Flexible GitHub automation platform with Claude. Auto-detects mode based on event type: PR reviews, @claude mentions, or custom automation."
 branding:
   icon: "at-sign"
   color: "orange"
@@ -24,11 +24,11 @@ inputs:
     required: false
     default: "claude/"
 
-  # Mode configuration
+  # Mode configuration (v1.0: auto-detected, kept for backward compatibility)
   mode:
-    description: "Execution mode for the action. Valid modes: 'tag' (default - triggered by mentions/assignments), 'agent' (for automation with no trigger checking), 'experimental-review' (experimental mode for code reviews with inline comments and suggestions)"
+    description: "DEPRECATED in v1.0: Mode is now auto-detected. Review mode for PRs, Tag mode for @claude mentions, Agent mode for automation."
     required: false
-    default: "tag"
+    default: ""
 
   # Claude Code configuration
   model:
@@ -52,12 +52,16 @@ inputs:
     description: "Additional custom instructions to include in the prompt for Claude"
     required: false
     default: ""
-  direct_prompt:
-    description: "Direct instruction for Claude (bypasses normal trigger detection)"
+  prompt:
+    description: "Instructions for Claude. Can be a direct prompt, slash command (e.g. /review), or custom template. Replaces override_prompt and direct_prompt from v0.x"
     required: false
     default: ""
   override_prompt:
-    description: "Complete replacement of Claude's prompt with custom template (supports variable substitution)"
+    description: "DEPRECATED: Use 'prompt' instead. Kept for backward compatibility."
+    required: false
+    default: ""
+  direct_prompt:
+    description: "DEPRECATED: Use 'prompt' instead. Kept for backward compatibility."
     required: false
     default: ""
   mcp_config:
@@ -144,6 +148,7 @@ runs:
         bun run ${GITHUB_ACTION_PATH}/src/entrypoints/prepare.ts
       env:
         MODE: ${{ inputs.mode }}
+        PROMPT: ${{ inputs.prompt }}
         TRIGGER_PHRASE: ${{ inputs.trigger_phrase }}
         ASSIGNEE_TRIGGER: ${{ inputs.assignee_trigger }}
         LABEL_TRIGGER: ${{ inputs.label_trigger }}

package.json

@@ -16,6 +16,8 @@
     "@octokit/graphql": "^8.2.2",
     "@octokit/rest": "^21.1.1",
     "@octokit/webhooks-types": "^7.6.1",
+    "@types/js-yaml": "^4.0.9",
+    "js-yaml": "^4.1.0",
     "node-fetch": "^3.3.2",
     "zod": "^3.24.4"
   },

src/create-prompt/index.ts

@@ -3,6 +3,7 @@
 import * as core from "@actions/core";
 import { writeFile, mkdir } from "fs/promises";
 import type { FetchDataResult } from "../github/data/fetcher";
+import { resolveSlashCommand } from "../slash-commands/loader";
 import {
   formatContext,
   formatBody,
@@ -118,6 +119,7 @@ export function prepareContext(
   const customInstructions = context.inputs.customInstructions;
   const allowedTools = context.inputs.allowedTools;
   const disallowedTools = context.inputs.disallowedTools;
+  const prompt = context.inputs.prompt; // v1.0: Unified prompt field
   const directPrompt = context.inputs.directPrompt;
   const overridePrompt = context.inputs.overridePrompt;
   const isPR = context.isPR;
@@ -157,6 +159,7 @@ export function prepareContext(
     ...(disallowedTools.length > 0 && {
       disallowedTools: disallowedTools.join(","),
     }),
+    ...(prompt && { prompt }),
     ...(directPrompt && { directPrompt }),
     ...(overridePrompt && { overridePrompt }),
     ...(claudeBranch && { claudeBranch }),
@@ -524,21 +527,62 @@ function substitutePromptVariables(
   return result;
 }
 
-export function generatePrompt(
+export async function generatePrompt(
   context: PreparedContext,
   githubData: FetchDataResult,
   useCommitSigning: boolean,
   mode: Mode,
-): string {
-  if (context.overridePrompt) {
-    return substitutePromptVariables(
-      context.overridePrompt,
-      context,
-      githubData,
-    );
+): Promise<string> {
+  // Check for unified prompt field first (v1.0)
+  let prompt =
+    context.prompt || context.overridePrompt || context.directPrompt || "";
+
+  // Handle slash commands
+  if (prompt.startsWith("/")) {
+    const variables = {
+      repository: context.repository,
+      pr_number:
+        context.eventData.isPR && "prNumber" in context.eventData
+          ? context.eventData.prNumber
+          : "",
+      issue_number:
+        !context.eventData.isPR && "issueNumber" in context.eventData
+          ? context.eventData.issueNumber
+          : "",
+      branch: context.eventData.claudeBranch || "",
+      base_branch: context.eventData.baseBranch || "",
+      trigger_user: context.triggerUsername,
+    };
+
+    const resolved = await resolveSlashCommand(prompt, variables);
+
+    // Apply any tools from the slash command
+    if (resolved.tools && resolved.tools.length > 0) {
+      const currentAllowedTools = process.env.ALLOWED_TOOLS || "";
+      const newTools = resolved.tools.join(",");
+      const combinedTools = currentAllowedTools
+        ? `${currentAllowedTools},${newTools}`
+        : newTools;
+      core.exportVariable("ALLOWED_TOOLS", combinedTools);
+    }
+
+    // Apply any settings from the slash command
+    if (resolved.settings) {
+      core.exportVariable(
+        "SLASH_COMMAND_SETTINGS",
+        JSON.stringify(resolved.settings),
+      );
+    }
+
+    prompt = resolved.expandedPrompt;
+  }
+
+  // If we have a prompt, use it (with variable substitution)
+  if (prompt) {
+    return substitutePromptVariables(prompt, context, githubData);
   }
 
-  // Use the mode's prompt generator
+  // Otherwise use the mode's default prompt generator
   return mode.generatePrompt(context, githubData, useCommitSigning);
 }
 
@@ -840,8 +884,8 @@ export async function createPrompt(
       recursive: true,
     });
 
-    // Generate the prompt directly
-    const promptContent = generatePrompt(
+    // Generate the prompt directly (now async due to slash commands)
+    const promptContent = await generatePrompt(
       preparedContext,
       githubData,
       context.inputs.useCommitSigning,

src/create-prompt/types.ts

@@ -6,8 +6,9 @@ export type CommonFields = {
   customInstructions?: string;
   allowedTools?: string;
   disallowedTools?: string;
-  directPrompt?: string;
-  overridePrompt?: string;
+  prompt?: string; // v1.0: Unified prompt field
+  directPrompt?: string; // Deprecated
+  overridePrompt?: string; // Deprecated
 };
 
 type PullRequestReviewCommentEvent = {

src/entrypoints/prepare.ts

@@ -10,30 +10,26 @@ import { setupGitHubToken } from "../github/token";
 import { checkWritePermissions } from "../github/validation/permissions";
 import { createOctokit } from "../github/api/client";
 import { parseGitHubContext, isEntityContext } from "../github/context";
-import { getMode, isValidMode, DEFAULT_MODE } from "../modes/registry";
-import type { ModeName } from "../modes/types";
+import { getMode } from "../modes/registry";
 import { prepare } from "../prepare";
 
 async function run() {
   try {
-    // Step 1: Get mode first to determine authentication method
-    const modeInput = process.env.MODE || DEFAULT_MODE;
+    // Parse GitHub context first to enable mode detection
+    const context = parseGitHubContext();
 
-    // Validate mode input
-    if (!isValidMode(modeInput)) {
-      throw new Error(`Invalid mode: ${modeInput}`);
-    }
-    const validatedMode: ModeName = modeInput;
+    // Auto-detect mode based on context, with optional override
+    const modeOverride = process.env.MODE;
+    const mode = getMode(context, modeOverride);
+    const modeName = mode.name;
 
-    // Step 2: Setup GitHub token based on mode
+    // Setup GitHub token based on mode
     let githubToken: string;
-    if (validatedMode === "experimental-review") {
-      // For experimental-review mode, use the default GitHub Action token
+    if (modeName === "review" || modeName === "experimental-review") {
+      // For review mode, use the default GitHub Action token
       githubToken = process.env.DEFAULT_WORKFLOW_TOKEN || "";
       if (!githubToken) {
-        throw new Error(
-          "DEFAULT_WORKFLOW_TOKEN not found for experimental-review mode",
-        );
+        throw new Error("DEFAULT_WORKFLOW_TOKEN not found for review mode");
       }
       console.log("Using default GitHub Action token for review mode");
       core.setOutput("GITHUB_TOKEN", githubToken);
@@ -43,9 +39,6 @@ async function run() {
     }
     const octokit = createOctokit(githubToken);
 
-    // Step 2: Parse GitHub context (once for all operations)
-    const context = parseGitHubContext();
-
     // Step 3: Check write permissions (only for entity contexts)
     if (isEntityContext(context)) {
       const hasWritePermissions = await checkWritePermissions(
@@ -59,8 +52,7 @@ async function run() {
       }
     }
 
-    // Step 4: Get mode and check trigger conditions
-    const mode = getMode(validatedMode, context);
+    // Check trigger conditions
     const containsTrigger = mode.shouldTrigger(context);
 
     // Set output for action.yml to check

src/github/context.ts

@@ -35,7 +35,6 @@ export type ScheduleEvent = {
   };
 };
 import type { ModeName } from "../modes/types";
-import { DEFAULT_MODE, isValidMode } from "../modes/registry";
 
 // Event name constants for better maintainability
 const ENTITY_EVENT_NAMES = [
@@ -63,15 +62,16 @@ type BaseContext = {
   };
   actor: string;
   inputs: {
-    mode: ModeName;
+    mode?: ModeName; // Optional for v1.0 backward compatibility
+    prompt: string; // New unified prompt field
     triggerPhrase: string;
     assigneeTrigger: string;
     labelTrigger: string;
     allowedTools: string[];
     disallowedTools: string[];
     customInstructions: string;
-    directPrompt: string;
-    overridePrompt: string;
+    directPrompt: string; // Deprecated, kept for compatibility
+    overridePrompt: string; // Deprecated, kept for compatibility
     baseBranch?: string;
     branchPrefix: string;
     useStickyComment: boolean;
@@ -105,10 +105,10 @@ export type GitHubContext = ParsedGitHubContext | AutomationContext;
 export function parseGitHubContext(): GitHubContext {
   const context = github.context;
 
-  const modeInput = process.env.MODE ?? DEFAULT_MODE;
-  if (!isValidMode(modeInput)) {
-    throw new Error(`Invalid mode: ${modeInput}.`);
-  }
+  // Mode is optional in v1.0 (auto-detected)
+  const modeInput = process.env.MODE
+    ? (process.env.MODE as ModeName)
+    : undefined;
 
   const commonFields = {
     runId: process.env.GITHUB_RUN_ID!,
@@ -120,15 +120,21 @@ export function parseGitHubContext(): GitHubContext {
     },
     actor: context.actor,
     inputs: {
-      mode: modeInput as ModeName,
+      mode: modeInput,
+      // v1.0: Unified prompt field with fallback to legacy fields
+      prompt:
+        process.env.PROMPT ||
+        process.env.OVERRIDE_PROMPT ||
+        process.env.DIRECT_PROMPT ||
+        "",
       triggerPhrase: process.env.TRIGGER_PHRASE ?? "@claude",
       assigneeTrigger: process.env.ASSIGNEE_TRIGGER ?? "",
       labelTrigger: process.env.LABEL_TRIGGER ?? "",
       allowedTools: parseMultilineInput(process.env.ALLOWED_TOOLS ?? ""),
       disallowedTools: parseMultilineInput(process.env.DISALLOWED_TOOLS ?? ""),
       customInstructions: process.env.CUSTOM_INSTRUCTIONS ?? "",
-      directPrompt: process.env.DIRECT_PROMPT ?? "",
-      overridePrompt: process.env.OVERRIDE_PROMPT ?? "",
+      directPrompt: process.env.DIRECT_PROMPT ?? "", // Deprecated
+      overridePrompt: process.env.OVERRIDE_PROMPT ?? "", // Deprecated
       baseBranch: process.env.BASE_BRANCH,
       branchPrefix: process.env.BRANCH_PREFIX ?? "claude/",
       useStickyComment: process.env.USE_STICKY_COMMENT === "true",