Feat: init-spec create abcoder skill instead of mcp; comperss output token; introduce search_symbol; auto parser into ~/.asts

.github/workflows/regression.yml

@@ -22,22 +22,24 @@ jobs:
         ['ASTVersion']
         ['Modules']['a.b/c']['Dependencies']['a.b/c']
         ['Modules']['a.b/c/cmdx']['Dependencies']['a.b/c/cmdx']
+        ['NameToFile']
+        ['NameToLocations']
     steps:
       - name: Checkout pull request code
         uses: actions/checkout@v4
         with:
-          path: 'pr_repo'
+          path: "pr_repo"
 
       - name: Checkout main branch code
         uses: actions/checkout@v4
         with:
-          ref: 'main'
-          path: 'main_repo'
+          ref: "main"
+          path: "main_repo"
 
       - name: Setup Go environment
         uses: actions/setup-go@v5
         with:
-          go-version: '1.22'
+          go-version: "1.22"
           cache-dependency-path: |
             main_repo/go.sum
             pr_repo/go.sum
@@ -51,18 +53,18 @@ jobs:
       - name: Setup Python environment
         uses: actions/setup-python@v5
         with:
-          python-version: '3.11'
+          python-version: "3.11"
 
       - name: Setup JDK 21
         uses: actions/setup-java@v4
         with:
-          java-version: '21'
-          distribution: 'temurin'
+          java-version: "21"
+          distribution: "temurin"
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: "22"
 
       - name: Compile both binaries
         run: |
@@ -82,8 +84,7 @@ jobs:
           echo "JDTLS_ROOT_PATH=$(realpath ./main_repo/lang/java/lsp/jdtls/jdt-language-server-*)" >> $GITHUB_ENV
 
       - name: Run OLD abcoder
-        run:
-          OUTDIR=out_old ABCEXE=./abcoder_old ./main_repo/script/run_testdata.sh all
+        run: OUTDIR=out_old ABCEXE=./abcoder_old ./main_repo/script/run_testdata.sh all
 
       - name: Reset dependencies
         run: |
@@ -95,8 +96,7 @@ jobs:
           OUTDIR=out_new ABCEXE=./abcoder_new ./pr_repo/script/run_testdata.sh first
 
       - name: Run NEW abcoder
-        run:
-          OUTDIR=out_new ABCEXE=./abcoder_new ./pr_repo/script/run_testdata.sh all
+        run: OUTDIR=out_new ABCEXE=./abcoder_new ./pr_repo/script/run_testdata.sh all
 
       - name: Upload output directories
         uses: actions/upload-artifact@v4

.gitignore

@@ -79,4 +79,5 @@ tools
 
 !testdata/asts/*.json
 
-.claude/
+.claude/
+!internal/cmd/assets/.claude/

README.md

@@ -118,6 +118,45 @@ Start coding(sub-agent) ─────────→ Execute Implementation
 
 > Watch the demo video [here](https://github.com/cloudwego/abcoder/pull/141)
 
+## Use ABCoder as a Skill
+
+The **Skill** interface provides native Claude Code integration without MCP protocol overhead. It uses Claude Code's built-in skill system for a more streamlined workflow.
+
+### Setup
+
+The Skill is automatically configured when you run `abcoder init-spec`. The skill definitions are located in `internal/cmd/assets/.claude/skills/`.
+
+### Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_repos` | List all available repositories |
+| `tree_repo` | Get repository file structure |
+| `get_file_structure` | Get all symbols in a file |
+| `get_file_symbol` | Get symbol details with dependencies and references |
+| `search_symbol` | Search symbols by name pattern |
+
+### Usage Example
+
+```bash
+# List all repositories
+abcoder cli list_repos
+
+# Get repository file tree
+abcoder cli tree_repo 'repo_name'
+
+# Get file structure
+abcoder cli get_file_structure 'repo_name' 'path/to/file.go'
+
+# Get symbol details
+abcoder cli get_file_symbol 'repo_name' 'path/to/file.go' 'SymbolName'
+
+# Search symbols
+abcoder cli search_symbol 'repo_name' 'Pattern*'
+```
+
+For Claude Code integration, the skill tools are invoked directly via slash commands like `/abcoder:schedule`.
+
 ## Use ABCoder as a MCP server
 
 1. Install ABCoder:
@@ -177,6 +216,44 @@ Start coding(sub-agent) ─────────→ Execute Implementation
 
 - Try to use [the recommended prompt](llm/prompt/analyzer.md) and combine planning/memory tools like [sequential-thinking](https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking) in your AI agent.
 
+### Skill vs MCP
+
+ABCoder provides two integration methods with Claude Code:
+
+| Feature | MCP (mcp__abcoder) | Skill (skill__abcoder) |
+|---------|-------------------|----------------------|
+| **Invocation** | `mcp__abcoder__tool_name` | `skill__abcoder__tool_name` |
+| **Definition** | MCP protocol | .claude/skills/ |
+| **Use Case** | General AI agents | Claude Code workflow |
+| **Auto Detection** | - | Auto-detect `current_repo` from cwd |
+| **Memory Efficient** | - | Sonic lazy-load, on-demand parsing |
+| **Pipeline Support** | - | `rg` filter, `jq` extract |
+| **Symbol Search** | - | Regex pattern support |
+| **Example** | `mcp__abcoder__get_file_symbol` | `skill__abcoder__get_file_symbol` |
+
+The **Skill** interface is the recommended approach for Claude Code users, providing a more streamlined workflow:
+
+- **Auto-detect current repo**: `list_repos` automatically detects repos that match current working directory
+- **Memory efficient**: Uses Sonic for lazy JSON parsing, only loads needed data
+- **Pipeline friendly**: Output can be piped to `rg` for filtering or `jq` for extraction
+- **Regex search**: `search_symbol` supports regex patterns to precisely locate symbols
+
+**Pipeline Examples:**
+```bash
+# Filter current repo(s) only
+abcoder cli list_repos | jq '.current_repo'
+
+# Search with regex
+abcoder cli search_symbol myrepo "^Get.*User$"
+
+# Filter related file
+abcoder cli tree_repo myrepo | rg 'related-file'
+
+# Filter dependencies only
+abcoder cli get_file_symbol myrepo src/main.go MyFunc | jq '.node.dependencies'
+```
+
+For detailed usage, see [Skill Definitions](internal/cmd/assets/.claude/skills/).
 
 ## Use ABCoder as an Agent (WIP)
 

go.mod

@@ -22,6 +22,7 @@ require (
 	github.com/spf13/cobra v1.8.1
 	github.com/stretchr/testify v1.10.0
 	github.com/vifraa/gopom v1.0.0
+	golang.org/x/exp v0.0.0-20250218142911-aa4b98e5adaa
 	golang.org/x/mod v0.24.0
 	golang.org/x/tools v0.32.0
 )
@@ -89,7 +90,6 @@ require (
 	github.com/yargevad/filepathx v1.0.0 // indirect
 	github.com/yosida95/uritemplate/v3 v3.0.2 // indirect
 	golang.org/x/arch v0.14.0 // indirect
-	golang.org/x/exp v0.0.0-20250218142911-aa4b98e5adaa // indirect
 	golang.org/x/net v0.39.0 // indirect
 	golang.org/x/sync v0.13.0 // indirect
 	golang.org/x/sys v0.33.0 // indirect