add batch-issue command to create GitHub issues from folder of docs

New `spark git batch-issue <repo> -d <docs>` command reads markdown files
from a folder and creates a GitHub issue for each one. Title is extracted
from the first `# heading` or falls back to the filename. Supports --dry-run
preview and --label flags. (Refs: #13)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: qdriven

cmd/git/batch_issue.go

@@ -0,0 +1,98 @@
+package git
+
+import (
+	"fmt"
+	"spark/internal/github"
+	"strings"
+
+	"github.com/pterm/pterm"
+	"github.com/spf13/cobra"
+)
+
+var (
+	batchIssueDocs   string
+	batchIssueDryRun bool
+	batchIssueLabels string
+)
+
+var batchIssueCmd = &cobra.Command{
+	Use:   "batch-issue <repo>",
+	Short: "Create GitHub issues from a folder of markdown documents",
+	Long: `Create GitHub issues from a folder of markdown documents.
+
+Each markdown file becomes one GitHub issue:
+- Title: extracted from the first "# heading" in the file, or the filename if no heading found
+- Body: the full content of the document
+
+Requires gh CLI to be installed and authenticated.`,
+	Args: cobra.ExactArgs(1),
+	Example: `  spark git batch-issue variableway/spark-cli -d ./docs
+  spark git batch-issue owner/repo -d ./issues --dry-run
+  spark git batch-issue owner/repo -d ./docs --label "documentation"`,
+	RunE: func(cmd *cobra.Command, args []string) error {
+		repo := args[0]
+
+		issues, err := github.ReadDocsAsIssues(batchIssueDocs)
+		if err != nil {
+			return err
+		}
+
+		var labels []string
+		if batchIssueLabels != "" {
+			labels = splitLabels(batchIssueLabels)
+		}
+
+		fmt.Printf("Found %d documents in '%s'\n\n", len(issues), batchIssueDocs)
+
+		if batchIssueDryRun {
+			pterm.Info.Println("Dry run mode - previewing issues:")
+			fmt.Println()
+			for i, issue := range issues {
+				fmt.Printf("[%d/%d] %s\n", i+1, len(issues), issue.Title)
+				fmt.Printf("  Labels: %v\n", labels)
+				fmt.Printf("  Body length: %d chars\n\n", len(issue.Body))
+			}
+			return nil
+		}
+
+		successCount := 0
+		failCount := 0
+
+		for i, issue := range issues {
+			fmt.Printf("[%d/%d] Creating issue: %s\n", i+1, len(issues), issue.Title)
+
+			if err := github.CreateIssue(repo, issue.Title, issue.Body, labels); err != nil {
+				pterm.Error.Printf("Failed: %v\n", err)
+				failCount++
+			} else {
+				pterm.Success.Printf("Created: %s\n", issue.Title)
+				successCount++
+			}
+		}
+
+		fmt.Printf("\n--- Summary ---\n")
+		fmt.Printf("Created: %d\n", successCount)
+		fmt.Printf("Failed: %d\n", failCount)
+
+		return nil
+	},
+}
+
+func splitLabels(labelStr string) []string {
+	var result []string
+	for _, l := range strings.Split(labelStr, ",") {
+		l = strings.TrimSpace(l)
+		if l != "" {
+			result = append(result, l)
+		}
+	}
+	return result
+}
+
+func init() {
+	GitCmd.AddCommand(batchIssueCmd)
+
+	batchIssueCmd.Flags().StringVarP(&batchIssueDocs, "docs", "d", ".", "Folder containing markdown documents")
+	batchIssueCmd.Flags().BoolVar(&batchIssueDryRun, "dry-run", false, "Preview issues without creating them")
+	batchIssueCmd.Flags().StringVarP(&batchIssueLabels, "label", "l", "", "Labels to add to all issues (comma-separated)")
+}

cmd/git/git.go

@@ -15,7 +15,8 @@ This includes:
 - gitcode: Add Gitcode as remote
 - config: Configure git user for repository
 - url: Get repository remote URL
-- batch-clone: Clone all repos from a GitHub organization or user`,
+- batch-clone: Clone all repos from a GitHub organization or user
+- batch-issue: Create GitHub issues from a folder of markdown documents`,
 }
 
 func init() {

docs/features/git.md

@@ -53,6 +53,21 @@ spark git batch-clone jackwener -o ./repos
 spark git update-org-status variableway --update-dot-github
 ```
 
+### 批量创建 Issue
+
+从文件夹中的 Markdown 文档批量创建 GitHub Issue。每个文档对应一个 Issue，标题自动提取自文档的首行标题。
+
+```bash
+# 从文档创建 Issue
+spark git batch-issue variableway/spark-cli -d ./docs
+
+# 预览模式
+spark git batch-issue owner/repo -d ./issues --dry-run
+
+# 添加标签
+spark git batch-issue owner/repo -d ./docs --label "documentation"
+```
+
 ## 使用参数
 
 | 参数 | 说明 |

docs/usage/git.md

@@ -14,6 +14,7 @@ spark git config [--username --email]         # 配置 Git 用户
 spark git url [repo-path]                     # 查看远程 URL
 spark git batch-clone <account> [-o <dir>]    # 克隆用户/组织所有仓库
 spark git update-org-status <org> [--dry-run] # 更新组织 README
+spark git batch-issue <repo> [-d <docs-dir>]    # 从文档批量创建 Issue
 ```
 
 ---
@@ -168,6 +169,28 @@ spark git update-org-status variableway --update-dot-github # 直接推送
 spark git update-org-status variableway --section "My Projects"
 ```
 
+---
+
+## spark git batch-issue
+
+从文件夹中的 Markdown 文档批量创建 GitHub Issue。每个文档对应一个 Issue。
+
+| 标志 | 简写 | 默认值 | 说明 |
+|------|------|--------|------|
+| `--docs` | `-d` | `.` | 包含 Markdown 文档的目录 |
+| `--dry-run` | | `false` | 预览不创建 |
+| `--label` | `-l` | | 为所有 Issue 添加标签（逗号分隔） |
+
+**标题规则**：
+- 优先使用文档中的第一个 `# 标题`
+- 无标题时使用文件名（去掉 `.md` 后缀）
+
+```bash
+spark git batch-issue variableway/spark-cli -d ./docs
+spark git batch-issue owner/repo -d ./issues --dry-run
+spark git batch-issue owner/repo -d ./docs --label "documentation,enhancement"
+```
+
 ## 相关命令
 
 - [Agent 配置](./agent.md)

internal/github/issue.go

@@ -0,0 +1,83 @@
+package github
+
+import (
+	"fmt"
+	"os"
+	"os/exec"
+	"path/filepath"
+	"strings"
+)
+
+type IssueInput struct {
+	Title string
+	Body  string
+}
+
+func CreateIssue(repo, title, body string, labels []string) error {
+	args := []string{"issue", "create", "--repo", repo, "--title", title, "--body", body}
+	for _, label := range labels {
+		args = append(args, "--label", label)
+	}
+
+	cmd := exec.Command("gh", args...)
+	cmd.Stdout = os.Stdout
+	cmd.Stderr = os.Stderr
+
+	if err := cmd.Run(); err != nil {
+		return fmt.Errorf("failed to create issue '%s': %w", title, err)
+	}
+
+	return nil
+}
+
+func ReadDocsAsIssues(dir string) ([]IssueInput, error) {
+	entries, err := os.ReadDir(dir)
+	if err != nil {
+		return nil, fmt.Errorf("failed to read directory '%s': %w", dir, err)
+	}
+
+	var issues []IssueInput
+	for _, entry := range entries {
+		if entry.IsDir() {
+			continue
+		}
+
+		name := entry.Name()
+		if !strings.HasSuffix(strings.ToLower(name), ".md") {
+			continue
+		}
+
+		filePath := filepath.Join(dir, name)
+		content, err := os.ReadFile(filePath)
+		if err != nil {
+			return nil, fmt.Errorf("failed to read file '%s': %w", filePath, err)
+		}
+
+		body := string(content)
+		title := extractTitle(body, name)
+
+		issues = append(issues, IssueInput{
+			Title: title,
+			Body:  body,
+		})
+	}
+
+	if len(issues) == 0 {
+		return nil, fmt.Errorf("no markdown files found in '%s'", dir)
+	}
+
+	return issues, nil
+}
+
+func extractTitle(content, filename string) string {
+	lines := strings.Split(content, "\n")
+	for _, line := range lines {
+		line = strings.TrimSpace(line)
+		if strings.HasPrefix(line, "# ") {
+			return strings.TrimSpace(strings.TrimPrefix(line, "#"))
+		}
+	}
+
+	ext := filepath.Ext(filename)
+	return strings.TrimSuffix(filename, ext)
+}

internal/github/issue_test.go

@@ -0,0 +1,103 @@
+package github
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+)
+
+func TestExtractTitle(t *testing.T) {
+	tests := []struct {
+		name     string
+		content  string
+		filename string
+		want     string
+	}{
+		{
+			name:     "extract from h1 heading",
+			content:  "# My Issue Title\n\nSome body content",
+			filename: "issue.md",
+			want:     "My Issue Title",
+		},
+		{
+			name:     "fallback to filename without extension",
+			content:  "No heading here\nJust body text",
+			filename: "my-issue.md",
+			want:     "my-issue",
+		},
+		{
+			name:     "skip h2 heading",
+			content:  "## This is h2\n# This is h1",
+			filename: "test.md",
+			want:     "This is h1",
+		},
+		{
+			name:     "heading with leading spaces",
+			content:  "  # Trimmed Title\nBody",
+			filename: "test.md",
+			want:     "Trimmed Title",
+		},
+		{
+			name:     "empty file uses filename",
+			content:  "",
+			filename: "empty-doc.md",
+			want:     "empty-doc",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			got := extractTitle(tt.content, tt.filename)
+			if got != tt.want {
+				t.Errorf("extractTitle() = %q, want %q", got, tt.want)
+			}
+		})
+	}
+}
+
+func TestReadDocsAsIssues(t *testing.T) {
+	dir := t.TempDir()
+
+	t.Run("reads markdown files as issues", func(t *testing.T) {
+		os.WriteFile(filepath.Join(dir, "issue1.md"), []byte("# First Issue\n\nBody of first issue"), 0644)
+		os.WriteFile(filepath.Join(dir, "issue2.md"), []byte("# Second Issue\n\nBody of second issue"), 0644)
+
+		issues, err := ReadDocsAsIssues(dir)
+		if err != nil {
+			t.Fatalf("ReadDocsAsIssues() error = %v", err)
+		}
+		if len(issues) != 2 {
+			t.Fatalf("expected 2 issues, got %d", len(issues))
+		}
+
+		titles := map[string]bool{issues[0].Title: true, issues[1].Title: true}
+		if !titles["First Issue"] || !titles["Second Issue"] {
+			t.Errorf("expected titles 'First Issue' and 'Second Issue', got %q and %q", issues[0].Title, issues[1].Title)
+		}
+	})
+
+	t.Run("returns error for empty directory", func(t *testing.T) {
+		emptyDir := t.TempDir()
+		_, err := ReadDocsAsIssues(emptyDir)
+		if err == nil {
+			t.Error("expected error for empty directory")
+		}
+	})
+
+	t.Run("ignores non-markdown files", func(t *testing.T) {
+		mixedDir := t.TempDir()
+		os.WriteFile(filepath.Join(mixedDir, "doc.md"), []byte("# Doc\nContent"), 0644)
+		os.WriteFile(filepath.Join(mixedDir, "ignore.txt"), []byte("Not a doc"), 0644)
+
+		issues, err := ReadDocsAsIssues(mixedDir)
+		if err != nil {
+			t.Fatalf("ReadDocsAsIssues() error = %v", err)
+		}
+		if len(issues) != 1 {
+			t.Fatalf("expected 1 issue, got %d", len(issues))
+		}
+		if issues[0].Title != "Doc" {
+			t.Errorf("expected title 'Doc', got %q", issues[0].Title)
+		}
+	})
+}