gemini-cli-extension-porting

分类: 工具与效率 | 上传者: dbmcco | 下载: 0 | 版本: v1.0（最新）

将珠子或超能力工作流程移植到 Gemini CLI 扩展中或设计模拟多步骤代理工作流程的 Gemini CLI 命令提示符时使用 - 涵盖扩展布局、GEMINI.md 上下文、命令 TOML 模式和可执行护栏（测试/CI/预提交）

更新日志: Source: GitHub https://github.com/dbmcco/claude-agent-toolkit

目录结构

当前层级: tree/main/skills/gemini-cli-extension-porting/

📄 SKILL.md 4.0 KB

SKILL.md

---
name: gemini-cli-extension-porting
description: Use when porting beads or superpowers workflows into Gemini CLI extensions or designing Gemini CLI command prompts that emulate multi-step agent workflows - covers extension layout, GEMINI.md context, command TOML patterns, and enforceable guardrails (tests/CI/pre-commit)
---

# Gemini CLI Extension Porting (Beads + Superpowers)

## Overview

Turn skills-based workflows into Gemini CLI extensions by mapping each workflow stage to a command, centralizing shared context in `GEMINI.md`, and backing prompt-only rules with repository guardrails.

## When to Use

- When converting Superpowers or beads workflows into Gemini CLI extension commands
- When designing `/namespace:command` flows with explicit artifacts and verification
- When you need TDD and quality gates enforced beyond prompt instructions
- When wiring MCP tools or shell commands into Gemini CLI workflows

## Core Principles

1. **Command-first, no hooks**: Invoke commands explicitly and document startup steps in `GEMINI.md`.
2. **Soft + hard enforcement**: Define the workflow in prompts and enforce it with CI/pre-commit.
3. **Small, composable commands**: Keep each command focused on one stage or artifact.
4. **Single source of truth**: Persist specs, plans, and checkpoints in files instead of chat history.

## Extension Skeleton (Pattern)

```
my-extension/
  gemini-extension.json
  GEMINI.md
  commands/
    superpowers/
      brainstorm.toml
      write-plan.toml
      execute-plan.toml
    beads/
      ready.toml
      show.toml
      update.toml
```

## Pattern: Map Skills to Commands

1. Inventory the entrypoints, artifacts, and success criteria in beads and Superpowers.
2. Define command names and expected outputs for each stage.
3. Write each command prompt to:
   - Load required context files
   - Run required tools or shell commands
   - Update artifacts (specs, plans, checkpoints)
   - Halt on failed tool calls or missing inputs
4. Keep naming consistent with existing skill namespaces (e.g., `superpowers`, `beads`).

## Pattern: Persistent Context in `GEMINI.md`

- Document the workflow rules and startup checklist (e.g., “Run `/beads:ready` at session start”).
- List required files, artifact paths, and expected status markers.
- Describe guardrails and when to stop for user confirmation.

## Pattern: Enforce TDD and Quality Gates

- In prompts, require Red/Green/Refactor and explicit test runs per task.
- In the repo, add hard gates (pre-commit + CI) for lint, type-check, tests, and coverage.
- Require plan updates and commit checkpoints after each task/phase.

## Pattern: Tool Wiring

- Configure MCP servers in `.gemini/settings.json` (workspace or user scope).
- Document required tools and environment variables in `GEMINI.md`.

## Common Workflow: Port Beads + Superpowers

```
1. Read the source skills and list core commands/artifacts.
2. Scaffold the extension and draft `GEMINI.md`.
3. Implement command TOMLs for brainstorm, plan, execute, and beads sync.
4. Add CI/pre-commit guardrails and verify they fail when tests fail.
5. Install the extension locally and confirm commands appear in `/help`.
```

## Integration with Other Skills

### With `model-mediated-development`
Use the model-mediated lens to keep decisions in prompts and logic in code.

### With `orchestrating-tmux-claudes` or `orchestrating-tmux-codex`
Use tmux orchestration when you need parallel execution or review of plan tasks.

### With `workspace-cleanup`
Reduce context noise before writing `GEMINI.md` or reading large repos.

## Checklist

- [ ] Inventory source skills and artifacts
- [ ] Define command namespaces and file layout
- [ ] Write `GEMINI.md` shared context
- [ ] Implement command TOMLs with clear stop conditions
- [ ] Add CI/pre-commit gates and test scripts
- [ ] Install and verify extension commands

## References

- https://geminicli.com/docs/extensions/
- https://geminicli.com/docs/cli/commands/
- https://github.com/google-gemini/gemini-cli
- https://github.com/obra/superpowers
- /Users/braydon/projects/experiments/tmux-beads-loops/skills/beads/SKILL.md

登录后下载/点赞/收藏 ❤ 11 | ★ 0

gemini-cli-extension-porting

目录结构

SKILL.md

举报内容

提示