gitea-cli-skill 0.1.7 → 0.1.8

package/assets/SKILL.md

@@ -74,6 +74,152 @@ When inside a git repo, `--branch` and `--ref` default to the current branch. `-
 
 **Env vars:** `GITEA_HOST`, `GITEA_TOKEN`, `GITEA_OWNER`, `GITEA_REPO`, `GITEA_OUTPUT`
 
+## Common Workflows
+
+### Workflow 1: Issue 处理
+
+处理用户反馈或 bug 报告的标准流程。
+
+```bash
+# 1. 查看当前 open 的 issues
+gitea-cli issue list --state open --output json
+
+# 2. 查看具体 issue 详情
+gitea-cli issue get <number> --output json
+
+# 3. 如果需要 label/milestone，先查找 ID
+gitea-cli label list --output json
+gitea-cli milestone list --output json
+
+# 4. 更新 issue（添加 label、milestone 等）
+gitea-cli issue update <number> --label <id> --milestone <id>
+
+# 5. 处理过程中添加评论记录进展
+gitea-cli issue comment create <number> -b "分析原因：..."
+
+# 6. 如果需要上传截图或日志
+gitea-cli issue attachment upload <number> ./screenshot.png
+
+# 7. 处理完成后关闭 issue
+gitea-cli issue close <number>
+```
+
+### Workflow 2: PR 工作流
+
+从创建分支到合并 PR 的完整流程。
+
+```bash
+# 1. 创建 feature 分支
+gitea-cli branch create feature/xyz --from main
+
+# 2. （本地开发完成后）查看当前分支列表确认
+gitea-cli branch list --output json
+
+# 3. 创建 PR
+gitea-cli pr create --title "feat: add new feature" --head feature/xyz --base main --body "## Summary\n- Changes made\n\n## Test plan\n- [ ] Unit tests pass"
+
+# 4. 查看 PR 状态
+gitea-cli pr get <index> --output json
+
+# 5. 检查 CI 状态（如果有 Actions 配置）
+gitea-cli actions run list --output json
+gitea-cli actions run jobs <run-id> --output json
+
+# 6. CI 通过后合并 PR
+gitea-cli pr merge <index> --strategy squash --delete-branch
+```
+
+### Workflow 3: Release 发布
+
+创建版本发布的完整流程。
+
+```bash
+# 1. 查看最近的提交，确定版本范围
+gitea-cli commit list --branch main --limit 20 --output json
+
+# 2. 查看现有 tags 和 releases
+gitea-cli tag list --output json
+gitea-cli release list --output json
+
+# 3. 创建 tag
+gitea-cli tag create v1.0.0 --target main -m "Release v1.0.0"
+
+# 4. 创建 release
+gitea-cli release create --tag v1.0.0 --name "v1.0.0" --body "## New Features\n- Feature A\n\n## Bug Fixes\n- Fix B" --target main
+
+# 5. 上传构建产物
+gitea-cli release asset upload v1.0.0 ./dist/binary-linux-amd64 --name binary-linux-amd64
+gitea-cli release asset upload v1.0.0 ./dist/binary-darwin-arm64 --name binary-darwin-arm64
+
+# 6. 确认 release 内容
+gitea-cli release get v1.0.0 --output json
+gitea-cli release asset list v1.0.0 --output json
+```
+
+### Workflow 4: CI/CD 监控与排障
+
+监控 pipeline 状态和排查失败的任务。
+
+```bash
+# 1. 查看最近的 runs
+gitea-cli actions run list --limit 10 --output json
+
+# 2. 查看失败 run 的 jobs
+gitea-cli actions run jobs <run-id> --output json
+
+# 3. 获取失败 job 的日志
+gitea-cli actions job logs <job-id> -o ./logs/
+
+# 4. 查看 job 详情（含步骤状态）
+gitea-cli actions job get <job-id> --output json
+
+# 5. 重新触发 workflow
+gitea-cli actions workflow dispatch <workflow-id> --ref main
+
+# 6. 查看构建产物
+gitea-cli actions artifact list --output json
+gitea-cli actions artifact download <artifact-id> -o ./dist/
+```
+
+### Workflow 5: 仓库文件修改
+
+通过 API 读取、修改、写回仓库文件。
+
+```bash
+# 1. 读取文件内容（获取当前版本）
+gitea-cli content get src/config.yaml --output json
+
+# 2. 在 feature 分支上创建新版本（--branch 省略时用当前分支）
+gitea-cli content create src/config.yaml --content "new: value" -m "add config"
+
+# 3. 更新已有文件（SHA 自动获取）
+gitea-cli content update src/config.yaml --content "updated: value" -m "update config"
+
+# 4. 或从本地文件上传
+gitea-cli content update src/config.yaml --file ./local-config.yaml -m "update config from local"
+
+# 5. 确认修改
+gitea-cli content get src/config.yaml --output json
+```
+
+### Workflow 6: 配置与多环境管理
+
+管理多个 Gitea 实例的 context 配置。
+
+```bash
+# 1. 查看当前配置
+gitea-cli config list --output json
+
+# 2. 添加新的 context
+gitea-cli config set --name work --host https://git.company.com --token <token> --default-owner myorg
+
+# 3. 临时使用另一个 context（不保存）
+gitea-cli issue list --context personal --output json
+
+# 4. 查看特定 context 详情
+gitea-cli config get work
+```
+
 ## Command Quick Reference
 
 ### Config
@@ -236,55 +382,6 @@ gitea-cli release asset download <tag> <asset-id> -o ./downloads/
 gitea-cli release asset delete <tag> <asset-id> --force
 ```
 
-## Common Patterns
-
-### Read file from repo, modify, write back
-
-```bash
-# 1. Get current content (captures SHA for update)
-gitea-cli content get src/config.yaml --output json --owner myorg --repo myrepo
-
-# 2. Update with new content (SHA auto-fetched if omitted)
-gitea-cli content update src/config.yaml --content "new: value" -m "update config" --owner myorg --repo myrepo
-```
-
-### Create issue with labels and milestone
-
-```bash
-# 1. Find label IDs
-gitea-cli label list --output json --owner myorg --repo myrepo
-
-# 2. Find milestone ID
-gitea-cli milestone list --output json --owner myorg --repo myrepo
-
-# 3. Create issue
-gitea-cli issue create -t "Fix login bug" -b "Description" --label 3 --label 7 --milestone 2 --owner myorg --repo myrepo
-```
-
-### Create issue with attachments
-
-```bash
-# Attach images (auto-embedded as markdown images) and files (embedded as links)
-gitea-cli issue create -t "Bug screenshot" -b "Steps to reproduce..." \
-  --attach ./screenshot.png --attach ./error.log --owner myorg --repo myrepo
-
-# Supported image formats: png, jpg, jpeg, gif, webp, bmp, svg
-# Other file types are embedded as download links
-```
-
-### Monitor CI/CD pipeline
-
-```bash
-# 1. Find latest run
-gitea-cli actions run list --limit 5 --output json
-
-# 2. Check job status
-gitea-cli actions run jobs <run-id> --output json
-
-# 3. Get logs for failed job
-gitea-cli actions job logs <job-id> -o ./logs/
-```
-
 ## Error Handling
 
 | Exit Code | Meaning |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitea-cli-skill",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Install gitea-cli as a Claude Code skill",
   "bin": {
     "gitea-cli-skill": "src/index.js"

package/src/index.js

@@ -65,6 +65,15 @@ function resolveSkillDir(platformName, targetPath) {
   return path.join(os.homedir(), PLATFORMS.claude.dir, SKILL_NAME);
 }
 
+// ── Find gitea-cli binary for the given platform ────────────────────────────
+
+function findGiteaCliBin(platformName, targetPath) {
+  const osArch = detectOSArch();
+  const binaryName = osArch.os === 'windows' ? 'gitea-cli.exe' : 'gitea-cli';
+  const skillDir = resolveSkillDir(platformName, targetPath);
+  return path.join(skillDir, 'scripts', `${osArch.os}-${osArch.arch}`, binaryName);
+}
+
 // ── HTTP via curl (robust cross-platform) ───────────────────────────────────
 
 function curlGet(url, token) {
@@ -132,39 +141,27 @@ function extractArchive(archivePath, destDir, osArch) {
   throw new Error(`Binary ${binaryName} not found in extracted archive`);
 }
 
-// ── Config generation ───────────────────────────────────────────────────────
+// ── Config via gitea-cli ────────────────────────────────────────────────────
 
-function writeGiteaCliConfig(host, token) {
-  const configDir = path.join(os.homedir(), '.config', 'gitea-cli');
-  const configPath = path.join(configDir, 'config.yaml');
-  const contextName = 'default';
-
-  // Read existing config if present
-  let existing = '';
-  if (fs.existsSync(configPath)) {
-    existing = fs.readFileSync(configPath, 'utf-8');
-    if (existing.includes(contextName)) {
-      console.log(`  Config already exists: ${configPath} (skipped)`);
-      return;
-    }
-  }
-
-  const newConfig = `${existing}contexts:
-- name: ${contextName}
-  host: ${host.replace(/\/$/, '')}
-  token: ${token}
-current-context: ${contextName}
-`;
+function configureContext({ giteaCliBin, host, token, contextName, defaultOwner, defaultRepo }) {
+  const ctxName = contextName || 'default';
+  const cmdArgs = [
+    `"${giteaCliBin}"`,
+    'config', 'set',
+    '--name', ctxName,
+    '--host', host.replace(/\/$/, ''),
+    '--token', token,
+  ];
+  if (defaultOwner) cmdArgs.push('--default-owner', defaultOwner);
+  if (defaultRepo) cmdArgs.push('--default-repo', defaultRepo);
 
-  fs.mkdirSync(configDir, { recursive: true });
-  fs.writeFileSync(configPath, newConfig, 'utf-8');
-  console.log(`  Config -> ${configPath}`);
+  execSync(cmdArgs.join(' '), { stdio: 'inherit', timeout: 10000 });
 }
 
 // ── Install command ─────────────────────────────────────────────────────────
 
 async function install(args) {
-  const { token: explicitToken, host: explicitHost, platform: platformName, target: targetPath, local: localDir, force } = args;
+  const { token: explicitToken, host: explicitHost, platform: platformName, target: targetPath, local: localDir, force, name: contextName, 'default-owner': defaultOwner, 'default-repo': defaultRepo } = args;
   const giteaHost = explicitHost || GITEA_HOST;
   const token = explicitToken || process.env.GITEA_TOKEN || null;
   const osArch = detectOSArch();
@@ -188,15 +185,26 @@ async function install(args) {
     console.log(`  Binary already exists: ${destBinary} (use --force to overwrite)`);
   } else if (localDir) {
     // --local: copy from local directory
-    await installFromLocal(localDir, scriptsDir, destBinary, osArch);
+    installFromLocal(localDir, scriptsDir, destBinary, osArch);
   } else {
     // Download from Gitea releases
     await installFromRelease(giteaHost, token, scriptsDir, destBinary, osArch);
   }
 
-  // 4. Write gitea-cli config if token provided
+  // 3. Configure context if token provided
   if (token) {
-    writeGiteaCliConfig(giteaHost, token);
+    const giteaCliBin = findGiteaCliBin(platformName, targetPath);
+    if (fs.existsSync(giteaCliBin)) {
+      console.log('  Configuring context...');
+      try {
+        configureContext({ giteaCliBin, host: giteaHost, token, contextName, defaultOwner, defaultRepo });
+      } catch (err) {
+        console.error(`  Failed to configure context: ${err.message}`);
+        console.error('  You can manually run: gitea-cli config set --name default --host <url> --token <token>');
+      }
+    } else {
+      console.log('  Binary not found for context setup, skipping.');
+    }
   }
 
   console.log(`\nDone!`);
@@ -207,7 +215,6 @@ async function install(args) {
 function installFromLocal(localDir, scriptsDir, destBinary, osArch) {
   // Goreleaser dist structure: dist/gitea-cli_<version>_<os>_<arch>/gitea-cli[.exe]
   const ext = osArch.os === 'windows' ? 'zip' : 'tar.gz';
-  const archiveName = `gitea-cli_*_${osArch.os}_${osArch.arch}.${ext}`;
 
   const resolvedDir = localDir.replace(/^~/, os.homedir());
 
@@ -294,7 +301,7 @@ async function installFromRelease(giteaHost, token, scriptsDir, destBinary, osAr
 // ── Context command ─────────────────────────────────────────────────────────
 
 async function addContext(args) {
-  const { token: explicitToken, host: explicitHost, 'default-owner': defaultOwner, 'default-repo': defaultRepo, name: contextName } = args;
+  const { token: explicitToken, host: explicitHost, platform: platformName, target: targetPath, 'default-owner': defaultOwner, 'default-repo': defaultRepo, name: contextName } = args;
   const host = explicitHost || GITEA_HOST;
   const token = explicitToken || process.env.GITEA_TOKEN || null;
 
@@ -307,40 +314,14 @@ async function addContext(args) {
     process.exit(1);
   }
 
-  // Find the installed gitea-cli binary
-  const osArch = detectOSArch();
-  const binaryName = osArch.os === 'windows' ? 'gitea-cli.exe' : 'gitea-cli';
-  const skillDir = path.join(os.homedir(), PLATFORMS.claude.dir, SKILL_NAME);
-  const giteaCliBin = path.join(skillDir, 'scripts', `${osArch.os}-${osArch.arch}`, binaryName);
+  const giteaCliBin = findGiteaCliBin(platformName, targetPath);
 
   if (!fs.existsSync(giteaCliBin)) {
-    // Fallback: write config manually
-    console.log('  gitea-cli binary not found, writing config directly...');
-    writeGiteaCliConfig(host, token);
-    console.log('Context configured successfully.');
-    return;
-  }
-
-  // Use gitea-cli config set for proper config management
-  const ctxName = contextName || 'default';
-  const cmdArgs = [
-    `"${giteaCliBin}"`,
-    'config', 'set',
-    '--name', ctxName,
-    '--host', host.replace(/\/$/, ''),
-    '--token', token,
-  ];
-  if (defaultOwner) cmdArgs.push('--default-owner', defaultOwner);
-  if (defaultRepo) cmdArgs.push('--default-repo', defaultRepo);
-
-  try {
-    execSync(cmdArgs.join(' '), { stdio: 'inherit', timeout: 10000 });
-  } catch (err) {
-    console.error(`Failed to configure context: ${err.message}`);
-    console.error('You can manually run:');
-    console.error(`  ${cmdArgs.join(' ')}`);
+    console.error('Error: gitea-cli binary not found. Run `npx gitea-cli-skill init` first.');
     process.exit(1);
   }
+
+  configureContext({ giteaCliBin, host, token, contextName, defaultOwner, defaultRepo });
 }
 
 // ── CLI ──────────────────────────────────────────────────────────────────────
@@ -374,49 +355,56 @@ function printHelp() {
   console.log(`gitea-cli-skill - Install gitea-cli as an AI agent skill
 
 Usage:
-  npx gitea-cli-skill init [flags]                          # Install skill
-  gitea-cli-skill add context [flags]                       # Configure Gitea API context
+  npx gitea-cli-skill init [flags]                          # Install + configure
+  gitea-cli-skill add context [flags]                       # Update context only
 
 Commands:
-  init                    Install skill (download binary + SKILL.md)
+  init                    Install skill (binary + SKILL.md) and optionally configure context
   add context             Add or update a Gitea API context (requires --token)
 
 Flags (init):
-  --token <t>       Gitea API token (needed for private repos, or set GITEA_TOKEN env var)
-  --host <url>      Gitea host URL (default: ${GITEA_HOST})
-  --local <dir>     Install from local goreleaser dist directory (skip download)
-  --platform <name> Target AI platform (default: claude)
-  --target <path>   Custom install directory (overrides --platform)
-  --force           Overwrite existing binary
+  --token <t>              Gitea API token (needed for private repos, enables auto-config)
+  --host <url>             Gitea host URL (default: ${GITEA_HOST})
+  --local <dir>            Install from local goreleaser dist directory (skip download)
+  --platform <name>        Target AI platform (default: claude)
+  --target <path>          Custom install directory (overrides --platform)
+  --name <name>            Context name for auto-config (default: "default")
+  --default-owner <owner>  Default owner for auto-config (optional)
+  --default-repo <repo>    Default repo for auto-config (optional)
+  --force                  Overwrite existing binary
 
 Flags (add context):
-  --name <name>           Context name (default: "default")
-  --host <url>            Gitea host URL (required)
-  --token <t>             Gitea API token (required, or set GITEA_TOKEN env var)
-  --default-owner <owner> Default repository owner (optional)
-  --default-repo <repo>   Default repository name (optional)
+  --name <name>            Context name (default: "default")
+  --host <url>             Gitea host URL (required)
+  --token <t>              Gitea API token (required, or set GITEA_TOKEN env var)
+  --default-owner <owner>  Default repository owner (optional)
+  --default-repo <repo>    Default repository name (optional)
+  --platform <name>        AI platform to locate binary (default: claude)
 
 Global:
-  -h, --help        Show this help
+  -h, --help               Show this help
 
 Platforms:
 ${platformList}
 
 Examples:
-  # Step 1: Install the skill (no token needed for public repos)
-  npx gitea-cli-skill init
+  # One-step install + configure (recommended)
+  npx gitea-cli-skill init --host https://gitea.example.com --token abc123
 
-  # Step 2: Configure context
-  gitea-cli-skill add context --host https://gitea.example.com --token abc123
+  # With default owner
+  npx gitea-cli-skill init --host https://gitea.example.com --token abc123 --default-owner myorg
 
-  # Configure context with all options
-  gitea-cli-skill add context --name work --host https://gitea.example.com --token abc123 --default-owner myorg
+  # Install only (public repo, no token needed)
+  npx gitea-cli-skill init
 
-  # Or install + configure in one step (for private repos)
-  npx gitea-cli-skill init --token abc123
+  # Update context later
+  gitea-cli-skill add context --host https://gitea.example.com --token new-token
 
-  # Or install from local build
+  # Install from local build
   npx gitea-cli-skill init --local ../dist
+
+  # Install for another AI platform
+  npx gitea-cli-skill init --platform cursor --host https://gitea.example.com --token abc123
 `);
 }