القائمة
Build libatbus-go, generate protobuf code, and manage dependencies. Use when: building the module, running code generation, resolving import errors, updating proto definitions, checking prerequisites.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
libatbus-go module structure, concurrency model, C++ parity patterns, and design decisions. Use when: understanding module organization, debugging concurrency issues, making design decisions, reviewing C++/Go differences, adding new features.
ECDH key exchange, encryption/compression algorithms, message framing, and access token authentication in libatbus-go. Use when: working with ConnectionContext, handshake flow, cipher negotiation, pack/unpack, cross-language crypto vectors, access_data signatures.
Run and write unit tests for libatbus-go. Use when: running tests, writing new test cases, debugging test failures, working with cross-language test vectors, testing concurrency safety, verifying C++ parity.
| name | build |
| description | Build libatbus-go, generate protobuf code, and manage dependencies. Use when: building the module, running code generation, resolving import errors, updating proto definitions, checking prerequisites. |
protoc (protobuf compiler)protoc-gen-go (go install google.golang.org/protobuf/cmd/protoc-gen-go@latest)protoc-gen-mutable (custom plugin, generates *_mutable.pb.go with Mutable/Clone/Merge extensions)# Generate protobuf code (recommended)
task generate-protocol
# Or run protoc directly
cd protocol && protoc --go_out=. --mutable_out=. \
--go_opt=paths=source_relative --mutable_opt=paths=source_relative \
--proto_path=./ ./*.proto
# Build all packages
go build ./...
# Run all tests
go test ./...
The protocol definition lives in protocol/libatbus_protocol.proto. Generated files:
| File | Generator | Content |
|---|---|---|
libatbus_protocol.pb.go | protoc-gen-go | Standard protobuf types |
libatbus_protocol_mutable.pb.go | protoc-gen-mutable | Mutable/Clone/Merge/Readonly extensions |
The generate.go file at module root contains:
//go:generate task generate-protocol
So you can also run: go generate ./...
github.com/atframework/libatbus-go
In the parent repo (atsf4g-go), this is referenced via go.mod replace:
replace github.com/atframework/libatbus-go => ./atframework/libatbus-go
| Dependency | Purpose |
|---|---|
github.com/atframework/atframe-utils-go | Utility library (LRU map, algorithms) |
github.com/spaolacci/murmur3 | Murmur3 hash for buffer management |
github.com/stretchr/testify | Test assertions |
golang.org/x/crypto | ChaCha20, XXTEA, extended crypto algorithms |
google.golang.org/protobuf | Protobuf runtime |
| Symptom | Fix |
|---|---|
protoc-gen-mutable: not found | Install the custom plugin from the parent repo's tools |
| Import cycle errors | Check that types/ does not import impl/ (types defines interfaces, impl provides implementations) |
| Stale generated code | Run task generate-protocol and verify protocol/*.pb.go timestamps |