code-abyss 1.5.1

package/skills/development/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: development
+description: 开发语言能力索引。Python、Go、Rust、TypeScript、Java、C++、Shell。当用户提到编程、开发、代码、语言时路由到此。
+---
+
+# 符箓秘典 · 开发语言能力中枢
+
+## 能力矩阵
+
+| Skill | 语言 | 核心能力 |
+|-------|------|----------|
+| [python](python.md) | Python | Web框架、数据处理、自动化 |
+| [go](go.md) | Go | 高并发、微服务、云原生 |
+| [rust](rust.md) | Rust | 系统编程、内存安全、高性能 |
+| [typescript](typescript.md) | TS/JS | 前后端、Node.js、React/Vue |
+| [java](java.md) | Java | 企业级、Spring、微服务 |
+| [cpp](cpp.md) | C/C++ | 系统底层、性能优化 |
+| [shell](shell.md) | Bash | 脚本自动化、系统管理 |
+
+## 语言选型指南
+
+```yaml
+Web 后端:
+  - 快速开发: Python (FastAPI/Django)
+  - 高性能: Go (Gin/Echo)
+  - 企业级: Java (Spring Boot)
+
+Web 前端:
+  - SPA: TypeScript + React/Vue
+  - SSR: Next.js/Nuxt.js
+
+系统编程:
+  - 内存安全: Rust
+  - 传统: C/C++
+
+脚本自动化:
+  - 通用: Python
+  - 系统: Bash/Shell
+
+安全工具:
+  - 快速原型: Python
+  - 高性能: Go/Rust
+```

package/skills/development/cpp.md

@@ -0,0 +1,246 @@
+---
+name: cpp
+description: C/C++ 开发。系统编程、性能优化、内存管理。当用户提到 C、C++、CMake、内存、指针时使用。
+---
+
+# 📜 符箓秘典 · C/C++
+
+
+## 现代 C++ (C++17/20)
+
+### 智能指针
+```cpp
+#include <memory>
+
+// unique_ptr - 独占所有权
+auto ptr = std::make_unique<MyClass>(args);
+ptr->method();
+
+// shared_ptr - 共享所有权
+auto shared = std::make_shared<MyClass>(args);
+auto copy = shared;  // 引用计数 +1
+
+// weak_ptr - 弱引用，不增加引用计数
+std::weak_ptr<MyClass> weak = shared;
+if (auto locked = weak.lock()) {
+    locked->method();
+}
+```
+
+### 容器与算法
+```cpp
+#include <vector>
+#include <algorithm>
+#include <ranges>
+
+std::vector<int> nums = {1, 2, 3, 4, 5};
+
+// 范围 for
+for (const auto& n : nums) {
+    std::cout << n << std::endl;
+}
+
+// 算法
+auto it = std::find(nums.begin(), nums.end(), 3);
+std::sort(nums.begin(), nums.end());
+
+// C++20 Ranges
+auto even = nums | std::views::filter([](int n) { return n % 2 == 0; });
+auto squared = nums | std::views::transform([](int n) { return n * n; });
+```
+
+### Lambda 表达式
+```cpp
+// 基础 lambda
+auto add = [](int a, int b) { return a + b; };
+
+// 捕获
+int x = 10;
+auto capture_val = [x]() { return x; };      // 值捕获
+auto capture_ref = [&x]() { return x; };     // 引用捕获
+auto capture_all = [=]() { return x; };      // 全部值捕获
+auto capture_all_ref = [&]() { return x; };  // 全部引用捕获
+
+// 泛型 lambda (C++14)
+auto generic = [](auto a, auto b) { return a + b; };
+```
+
+### 并发编程
+```cpp
+#include <thread>
+#include <mutex>
+#include <future>
+
+// 线程
+std::thread t([]() {
+    std::cout << "Hello from thread" << std::endl;
+});
+t.join();
+
+// 互斥锁
+std::mutex mtx;
+{
+    std::lock_guard<std::mutex> lock(mtx);
+    // 临界区
+}
+
+// async/future
+auto future = std::async(std::launch::async, []() {
+    return compute_result();
+});
+auto result = future.get();
+
+// 条件变量
+std::condition_variable cv;
+std::unique_lock<std::mutex> lock(mtx);
+cv.wait(lock, []() { return ready; });
+```
+
+## 内存管理
+
+### RAII 模式
+```cpp
+class FileHandle {
+public:
+    FileHandle(const char* path) : file(fopen(path, "r")) {
+        if (!file) throw std::runtime_error("Failed to open file");
+    }
+
+    ~FileHandle() {
+        if (file) fclose(file);
+    }
+
+    // 禁止拷贝
+    FileHandle(const FileHandle&) = delete;
+    FileHandle& operator=(const FileHandle&) = delete;
+
+    // 允许移动
+    FileHandle(FileHandle&& other) noexcept : file(other.file) {
+        other.file = nullptr;
+    }
+
+private:
+    FILE* file;
+};
+```
+
+### 内存安全检查
+```bash
+# AddressSanitizer
+g++ -fsanitize=address -g main.cpp -o main
+./main
+
+# Valgrind
+valgrind --leak-check=full ./main
+
+# 静态分析
+clang-tidy main.cpp
+cppcheck main.cpp
+```
+
+## CMake
+
+### CMakeLists.txt
+```cmake
+cmake_minimum_required(VERSION 3.16)
+project(MyProject VERSION 1.0.0 LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+# 添加可执行文件
+add_executable(myapp
+    src/main.cpp
+    src/utils.cpp
+)
+
+# 添加库
+add_library(mylib STATIC
+    src/lib.cpp
+)
+
+# 链接库
+target_link_libraries(myapp PRIVATE mylib)
+
+# 包含目录
+target_include_directories(myapp PRIVATE ${CMAKE_SOURCE_DIR}/include)
+
+# 查找外部库
+find_package(Threads REQUIRED)
+target_link_libraries(myapp PRIVATE Threads::Threads)
+
+# 测试
+enable_testing()
+add_executable(tests tests/test_main.cpp)
+add_test(NAME MyTests COMMAND tests)
+```
+
+### 构建
+```bash
+mkdir build && cd build
+cmake ..
+cmake --build .
+ctest  # 运行测试
+```
+
+## 测试
+
+### Google Test
+```cpp
+#include <gtest/gtest.h>
+
+TEST(MathTest, Add) {
+    EXPECT_EQ(add(1, 2), 3);
+    EXPECT_EQ(add(-1, 1), 0);
+}
+
+TEST(MathTest, Divide) {
+    EXPECT_DOUBLE_EQ(divide(10, 2), 5.0);
+    EXPECT_THROW(divide(1, 0), std::invalid_argument);
+}
+
+// Fixture
+class UserTest : public ::testing::Test {
+protected:
+    void SetUp() override {
+        user = std::make_unique<User>("Alice");
+    }
+
+    std::unique_ptr<User> user;
+};
+
+TEST_F(UserTest, GetName) {
+    EXPECT_EQ(user->getName(), "Alice");
+}
+```
+
+## 项目结构
+
+```
+myproject/
+├── CMakeLists.txt
+├── include/
+│   └── myproject/
+│       ├── utils.h
+│       └── types.h
+├── src/
+│   ├── main.cpp
+│   └── utils.cpp
+├── tests/
+│   └── test_main.cpp
+└── build/
+```
+
+## 常用库
+
+| 库 | 用途 |
+|---|------|
+| Boost | 通用库集合 |
+| fmt | 格式化输出 |
+| spdlog | 日志 |
+| nlohmann/json | JSON |
+| Catch2/GTest | 测试 |
+| OpenSSL | 加密 |
+
+---
+

package/skills/development/go.md

@@ -0,0 +1,323 @@
+---
+name: go
+description: Go 开发。高并发、微服务、云原生、CLI工具。当用户提到 Go、Golang、Gin、Echo、goroutine 时使用。
+---
+
+# 📜 符箓秘典 · Go
+
+
+## Web 框架
+
+### Gin
+```go
+package main
+
+import (
+    "net/http"
+    "github.com/gin-gonic/gin"
+)
+
+type User struct {
+    ID    int    `json:"id"`
+    Name  string `json:"name" binding:"required"`
+    Email string `json:"email" binding:"required,email"`
+}
+
+func main() {
+    r := gin.Default()
+
+    // 中间件
+    r.Use(gin.Logger())
+    r.Use(gin.Recovery())
+
+    // 路由组
+    api := r.Group("/api")
+    {
+        api.GET("/users/:id", getUser)
+        api.POST("/users", createUser)
+        api.PUT("/users/:id", updateUser)
+        api.DELETE("/users/:id", deleteUser)
+    }
+
+    r.Run(":8080")
+}
+
+func getUser(c *gin.Context) {
+    id := c.Param("id")
+    c.JSON(http.StatusOK, gin.H{"id": id})
+}
+
+func createUser(c *gin.Context) {
+    var user User
+    if err := c.ShouldBindJSON(&user); err != nil {
+        c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+        return
+    }
+    c.JSON(http.StatusCreated, user)
+}
+```
+
+### Echo
+```go
+package main
+
+import (
+    "net/http"
+    "github.com/labstack/echo/v4"
+    "github.com/labstack/echo/v4/middleware"
+)
+
+func main() {
+    e := echo.New()
+
+    e.Use(middleware.Logger())
+    e.Use(middleware.Recover())
+
+    e.GET("/users/:id", getUser)
+    e.POST("/users", createUser)
+
+    e.Logger.Fatal(e.Start(":8080"))
+}
+
+func getUser(c echo.Context) error {
+    id := c.Param("id")
+    return c.JSON(http.StatusOK, map[string]string{"id": id})
+}
+```
+
+## 并发编程
+
+### Goroutine & Channel
+```go
+package main
+
+import (
+    "fmt"
+    "sync"
+)
+
+// 基础并发
+func worker(id int, jobs <-chan int, results chan<- int) {
+    for j := range jobs {
+        results <- j * 2
+    }
+}
+
+func main() {
+    jobs := make(chan int, 100)
+    results := make(chan int, 100)
+
+    // 启动 worker
+    for w := 1; w <= 3; w++ {
+        go worker(w, jobs, results)
+    }
+
+    // 发送任务
+    for j := 1; j <= 9; j++ {
+        jobs <- j
+    }
+    close(jobs)
+
+    // 收集结果
+    for a := 1; a <= 9; a++ {
+        <-results
+    }
+}
+
+// WaitGroup
+func parallelFetch(urls []string) []string {
+    var wg sync.WaitGroup
+    results := make([]string, len(urls))
+
+    for i, url := range urls {
+        wg.Add(1)
+        go func(i int, url string) {
+            defer wg.Done()
+            results[i] = fetch(url)
+        }(i, url)
+    }
+
+    wg.Wait()
+    return results
+}
+
+// Context 控制
+func fetchWithTimeout(ctx context.Context, url string) (string, error) {
+    ctx, cancel := context.WithTimeout(ctx, 5*time.Second)
+    defer cancel()
+
+    req, _ := http.NewRequestWithContext(ctx, "GET", url, nil)
+    resp, err := http.DefaultClient.Do(req)
+    if err != nil {
+        return "", err
+    }
+    defer resp.Body.Close()
+
+    body, _ := io.ReadAll(resp.Body)
+    return string(body), nil
+}
+```
+
+## 错误处理
+
+```go
+package main
+
+import (
+    "errors"
+    "fmt"
+)
+
+// 自定义错误
+var ErrNotFound = errors.New("not found")
+
+type ValidationError struct {
+    Field   string
+    Message string
+}
+
+func (e *ValidationError) Error() string {
+    return fmt.Sprintf("%s: %s", e.Field, e.Message)
+}
+
+// 错误包装
+func getUser(id int) (*User, error) {
+    user, err := db.FindUser(id)
+    if err != nil {
+        return nil, fmt.Errorf("getUser(%d): %w", id, err)
+    }
+    return user, nil
+}
+
+// 错误检查
+func handleUser(id int) error {
+    user, err := getUser(id)
+    if err != nil {
+        if errors.Is(err, ErrNotFound) {
+            return nil // 忽略未找到
+        }
+        return err
+    }
+    // 处理 user
+    return nil
+}
+```
+
+## 测试
+
+```go
+package main
+
+import (
+    "testing"
+    "github.com/stretchr/testify/assert"
+)
+
+func TestAdd(t *testing.T) {
+    result := Add(1, 2)
+    assert.Equal(t, 3, result)
+}
+
+// 表驱动测试
+func TestAddTable(t *testing.T) {
+    tests := []struct {
+        name     string
+        a, b     int
+        expected int
+    }{
+        {"positive", 1, 2, 3},
+        {"zero", 0, 0, 0},
+        {"negative", -1, 1, 0},
+    }
+
+    for _, tt := range tests {
+        t.Run(tt.name, func(t *testing.T) {
+            assert.Equal(t, tt.expected, Add(tt.a, tt.b))
+        })
+    }
+}
+
+// Benchmark
+func BenchmarkAdd(b *testing.B) {
+    for i := 0; i < b.N; i++ {
+        Add(1, 2)
+    }
+}
+```
+
+```bash
+go test ./...
+go test -v
+go test -cover
+go test -bench=.
+go test -race  # 竞态检测
+```
+
+## CLI 工具
+
+### Cobra
+```go
+package main
+
+import (
+    "fmt"
+    "github.com/spf13/cobra"
+)
+
+var rootCmd = &cobra.Command{
+    Use:   "myapp",
+    Short: "My CLI application",
+}
+
+var serveCmd = &cobra.Command{
+    Use:   "serve",
+    Short: "Start the server",
+    Run: func(cmd *cobra.Command, args []string) {
+        port, _ := cmd.Flags().GetInt("port")
+        fmt.Printf("Starting server on port %d\n", port)
+    },
+}
+
+func init() {
+    serveCmd.Flags().IntP("port", "p", 8080, "Port to listen on")
+    rootCmd.AddCommand(serveCmd)
+}
+
+func main() {
+    rootCmd.Execute()
+}
+```
+
+## 项目结构
+
+```
+myproject/
+├── go.mod
+├── go.sum
+├── main.go
+├── cmd/
+│   └── myapp/
+│       └── main.go
+├── internal/
+│   ├── handler/
+│   ├── service/
+│   └── repository/
+├── pkg/
+│   └── utils/
+└── tests/
+```
+
+## 常用库
+
+| 库 | 用途 |
+|---|------|
+| gin/echo | Web 框架 |
+| gorm | ORM |
+| cobra | CLI |
+| viper | 配置 |
+| zap/zerolog | 日志 |
+| testify | 测试 |
+| wire | 依赖注入 |
+
+---
+