abelworkflow 0.1.0

package/skills/dev-browser/src/snapshot/index.ts

@@ -0,0 +1,14 @@
+/**
+ * ARIA Snapshot module for dev-browser.
+ *
+ * Provides Playwright-compatible ARIA snapshots with cross-connection ref persistence.
+ * Refs are stored on window.__devBrowserRefs and survive across Playwright reconnections.
+ *
+ * Usage:
+ *   import { getSnapshotScript } from './snapshot';
+ *   const script = getSnapshotScript();
+ *   await page.evaluate(script);
+ *   // Now window.__devBrowser_getAISnapshot() and window.__devBrowser_selectSnapshotRef(ref) are available
+ */
+
+export { getSnapshotScript, clearSnapshotScriptCache } from "./browser-script";

package/skills/dev-browser/src/snapshot/inject.ts

@@ -0,0 +1,13 @@
+/**
+ * Injectable snapshot script for browser context.
+ *
+ * This module provides the getSnapshotScript function that returns a
+ * self-contained JavaScript string for injection into browser contexts.
+ *
+ * The script is injected via page.evaluate() and exposes:
+ * - window.__devBrowser_getAISnapshot(): Returns ARIA snapshot YAML
+ * - window.__devBrowser_selectSnapshotRef(ref): Returns element for given ref
+ * - window.__devBrowserRefs: Map of ref -> Element (persists across connections)
+ */
+
+export { getSnapshotScript, clearSnapshotScriptCache } from "./browser-script";

package/skills/dev-browser/src/types.ts

@@ -0,0 +1,34 @@
+// API request/response types - shared between client and server
+
+export interface ServeOptions {
+  port?: number;
+  headless?: boolean;
+  cdpPort?: number;
+  /** Directory to store persistent browser profiles (cookies, localStorage, etc.) */
+  profileDir?: string;
+}
+
+export interface ViewportSize {
+  width: number;
+  height: number;
+}
+
+export interface GetPageRequest {
+  name: string;
+  /** Optional viewport size for new pages */
+  viewport?: ViewportSize;
+}
+
+export interface GetPageResponse {
+  wsEndpoint: string;
+  name: string;
+  targetId: string; // CDP target ID for reliable page matching
+}
+
+export interface ListPagesResponse {
+  pages: string[];
+}
+
+export interface ServerInfoResponse {
+  wsEndpoint: string;
+}

package/skills/dev-browser/tsconfig.json

@@ -0,0 +1,36 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Path aliases
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  },
+  "include": ["src/**/*", "scripts/**/*"]
+}

package/skills/dev-browser/vitest.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: "node",
+    include: ["src/**/*.test.ts"],
+    testTimeout: 60000, // Playwright tests can be slow
+    hookTimeout: 60000,
+    teardownTimeout: 60000,
+  },
+});

package/skills/git-commit/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: git-commit
+description: 'Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping'
+license: MIT
+allowed-tools: Bash
+---
+
+# Git Commit with Conventional Commits
+
+## Overview
+
+Create standardized, semantic git commits using the Conventional Commits specification. Analyze the actual diff to determine appropriate type, scope, and message.
+
+## Conventional Commit Format
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+## Commit Types
+
+| Type       | Purpose                        |
+| ---------- | ------------------------------ |
+| `feat`     | New feature                    |
+| `fix`      | Bug fix                        |
+| `docs`     | Documentation only             |
+| `style`    | Formatting/style (no logic)    |
+| `refactor` | Code refactor (no feature/fix) |
+| `perf`     | Performance improvement        |
+| `test`     | Add/update tests               |
+| `build`    | Build system/dependencies      |
+| `ci`       | CI/config changes              |
+| `chore`    | Maintenance/misc               |
+| `revert`   | Revert commit                  |
+
+## Breaking Changes
+
+```
+# Exclamation mark after type/scope
+feat!: remove deprecated endpoint
+
+# BREAKING CHANGE footer
+feat: allow config to extend other configs
+
+BREAKING CHANGE: `extends` key behavior changed
+```
+
+## Workflow
+
+### 1. Analyze Diff
+
+```bash
+# If files are staged, use staged diff
+git diff --staged
+
+# If nothing staged, use working tree diff
+git diff
+
+# Also check status
+git status --porcelain
+```
+
+### 2. Stage Files (if needed)
+
+If nothing is staged or you want to group changes differently:
+
+```bash
+# Stage specific files
+git add path/to/file1 path/to/file2
+
+# Stage by pattern
+git add *.test.*
+git add src/components/*
+
+# Interactive staging
+git add -p
+```
+
+**Never commit secrets** (.env, credentials.json, private keys).
+
+### 3. Generate Commit Message
+
+Analyze the diff to determine:
+
+- **Type**: What kind of change is this?
+- **Scope**: What area/module is affected?
+- **Description**: One-line summary of what changed (present tense, imperative mood, <72 chars)
+
+### 4. Execute Commit
+
+```bash
+# Single line
+git commit -m "<type>[scope]: <description>"
+
+# Multi-line with body/footer
+git commit -m "$(cat <<'EOF'
+<type>[scope]: <description>
+
+<optional body>
+
+<optional footer>
+EOF
+)"
+```
+
+## Best Practices
+
+- One logical change per commit
+- Present tense: "add" not "added"
+- Imperative mood: "fix bug" not "fixes bug"
+- Reference issues: `Closes #123`, `Refs #456`
+- Keep description under 72 characters
+
+## Git Safety Protocol
+
+- NEVER update git config
+- NEVER run destructive commands (--force, hard reset) without explicit request
+- NEVER skip hooks (--no-verify) unless user asks
+- NEVER force push to main/master
+- If commit fails due to hooks, fix and create NEW commit (don't amend)

package/skills/grok-search/.env.example

@@ -0,0 +1,24 @@
+# GrokSearch 命令行工具配置
+# 将此文件复制为 .env 并填入你的配置值
+
+# 必填项：Grok API 端点（OpenAI 兼容格式）
+GROK_API_URL=
+# 必填项：你的 API 密钥
+GROK_API_KEY=
+
+# 可选项：使用的 Grok 模型（默认：grok-4-fast）
+# 常用选项：grok-4-fast
+GROK_MODEL=
+
+# 可选项：启用调试模式（true/false）
+GROK_DEBUG=false
+
+# 可选项：重试配置
+# GROK_RETRY_MAX_ATTEMPTS=3
+# GROK_RETRY_MULTIPLIER=1
+# GROK_RETRY_MAX_WAIT=5
+
+# 可选项：Tavily（启用高保真 web_fetch/web_map，以及 web_search 的额外来源）
+TAVILY_ENABLED=true
+TAVILY_API_URL=https://api.tavily.com
+TAVILY_API_KEY=

package/skills/grok-search/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: grok-search
+description: |
+  Enhanced web search and real-time content retrieval via Grok API. Use when: (1) Web search / information retrieval / fact-checking, (2) Webpage content extraction / URL parsing, (3) Breaking knowledge cutoff limits for current information, (4) Real-time news and technical documentation, (5) Multi-source information aggregation. Triggers: "search for", "find information about", "latest news", "current", "fetch webpage", "get content from URL". IMPORTANT: This skill REPLACES built-in WebSearch/WebFetch with CLI commands.
+---
+
+# Grok Search
+
+Enhanced web search via Grok API CLI.
+
+## CLI Commands
+
+```bash
+# Canonical entrypoint (agents + cross-platform)
+# - Resolve the installed skill directory first; do not assume the current repo contains skills/grok-search
+# - Prefer user-level skill directories under $HOME first, for example:
+#   $HOME/.claude/skills/grok-search
+#   $HOME/.codex/skills/grok-search
+#   $HOME/.config/agents/skills/grok-search
+# - If not found, check project-level locations:
+#   .claude/skills/grok-search
+#   .codex/skills/grok-search
+#   .agents/skills/grok-search
+# - Use system python only to bootstrap; entry.py creates/reuses repo-local .venv
+# - Never invoke scripts/groksearch_cli.py directly
+#
+# One-time setup:
+#   cp .env.example .env
+python "<SKILL_DIR>/scripts/groksearch_entry.py" --help
+
+# Environment (required): GROK_API_URL, GROK_API_KEY
+# Environment (optional): GROK_MODEL, GROK_DEBUG, GROK_RETRY_*
+# Environment (optional fetch/map): TAVILY_API_KEY, TAVILY_API_URL, TAVILY_ENABLED
+#
+# .env path:
+# skills/grok-search/.env
+#
+# Bootstrap controls (optional):
+# GROKSEARCH_VENV_DIR=/path/to/venv
+# GROKSEARCH_PYTHON=3.12
+# AGENTS_SKILLS_PYTHON=/abs/path/to/python
+
+# Optional if you intentionally change into the installed skill directory first:
+# cd "<SKILL_DIR>" && python scripts/groksearch_entry.py --help
+
+# Web search
+python "<SKILL_DIR>/scripts/groksearch_entry.py" web_search --query "search terms" [--platform "GitHub"] [--min-results 3] [--max-results 10] [--model "grok-4-fast"] [--extra-sources 6]
+# If you need broader search coverage, you can add Tavily sources explicitly, for example: --extra-sources 3
+
+# Fetch webpage
+python "<SKILL_DIR>/scripts/groksearch_entry.py" web_fetch --url "https://..." [--out file.md] [--fallback-grok]
+
+# Map website structure (Tavily)
+python "<SKILL_DIR>/scripts/groksearch_entry.py" web_map --url "https://..." [--max-depth 2] [--limit 80]
+
+# Check config
+python "<SKILL_DIR>/scripts/groksearch_entry.py" get_config_info [--no-test]
+
+# Toggle built-in tools
+python "<SKILL_DIR>/scripts/groksearch_entry.py" toggle_builtin_tools --action on|off|status [--root /path/to/project]
+```
+
+## Tool Routing Policy
+### Forced Replacement Rules
+
+| Scenario | Disabled | Use Instead |
+|----------|----------|-------------|
+| Web Search | `WebSearch` | CLI `web_search` via `groksearch_entry.py` |
+| Web Fetch | `WebFetch` | CLI `web_fetch` via `groksearch_entry.py` |
+
+### Tool Capability Matrix
+
+| Tool | Parameters | Output |
+|------|------------|--------|
+| `web_search` | `query`(required), `platform`/`min_results`/`max_results`/`model`/`extra_sources`(optional) | `[{title,url,description}]` |
+| `web_fetch` | `url`(required), `out`/`fallback_grok`(optional) | Structured Markdown |
+| `web_map` | `url`(required), `instructions`/`max_depth`/`max_breadth`/`limit`/`timeout`(optional) | JSON string |
+| `get_config_info` | `no_test`(optional) | `{api_url,status,connection_test}` |
+| `toggle_builtin_tools` | `action`(on/off/status), `root`(optional) | `{blocked,deny_list}` |
+
+## Search Workflow
+
+### Phase 1: Query Construction
+- **Intent Recognition**: Broad search → `web_search` | Deep retrieval → `web_fetch`
+- **Parameter Optimization**: Set `platform` for specific sources, adjust result counts; if you need broader source coverage, consider adding `--extra-sources 3`
+
+### Phase 2: Search Execution
+1. Start with `web_search` for structured summaries
+2. Use `web_fetch` on key URLs if summaries insufficient
+3. Retry with adjusted query if first round unsatisfactory
+
+### Phase 3: Result Synthesis
+1. Cross-reference multiple sources
+2. **Must annotate source and date** for time-sensitive info
+3. **Must include source URLs**: `Title [<sup>1</sup>](URL)`
+
+## Error Handling
+
+| Error | Recovery |
+|-------|----------|
+| Connection Failure | Run `get_config_info`, verify API URL/Key |
+| No Results | Broaden search terms |
+| Fetch Timeout | Try alternative sources |
+| Tavily unavailable while using `--extra-sources` | Command keeps Grok results and prints a Tavily warning to stderr |
+| Tavily extract failure | Use `--fallback-grok`, or inspect the Tavily warning/error message |
+
+## Anti-Patterns
+
+| Prohibited | Correct |
+|------------|---------|
+| No source citation | Include `Source [<sup>1</sup>](URL)` |
+| Assume current repo has `skills/grok-search` | Check global skill directories under `$HOME` first, then project-level `.claude/.codex/.agents`, then call `<SKILL_DIR>/scripts/groksearch_entry.py` |
+| Call `scripts/groksearch_cli.py` directly | Call `python scripts/groksearch_entry.py ...` |
+| Use built-in WebSearch/WebFetch | Use GrokSearch CLI |

package/skills/grok-search/requirements.txt

@@ -0,0 +1,2 @@
+httpx>=0.24,<1
+tenacity>=8,<10