Fundamental Ramen - User contributions [en]

Go/Quick Start

2026-07-27T09:40:43Z

Tacoball: /* naming convention table */

Go/Quick Start

2026-07-27T09:40:26Z

Tacoball: /* naming convention table */

Go/Quick Start

2026-07-27T09:39:50Z

Tacoball: /* naming convention table */

2026-07-27T02:57:45Z

Tacoball: /* naming convention table */

= Create a module =

Create module and source file.

<syntaxhighlight lang="bash">
go mod init sandbox/hello
touch hello.go
</syntaxhighlight>

Add source code.

<syntaxhighlight lang="go">
package main

import "fmt"

func main() {
fmt.Println("Hello, World!")
}
</syntaxhighlight>

Run.

<syntaxhighlight lang="bash">
go run .
</syntaxhighlight>

= Work with 2 modules =

<syntaxhighlight lang="bash">
mkdir main greetings sucks
cd greetings
go mod init sandbox/greetings
cd ../sucks
go mod init sandbox/sucks
cd ../main
go mod init
go mod edit -replace sandbox/greetings=../greetings
go mod edit -replace sandbox/sucks=../sucks
go mod tidy
</syntaxhighlight>

= naming convention table =

{| class="wikitable"
! Element
! Visibility
! Casing Rule
! Example
! Notes
|-
| Package
| N/A
| Lowercase
| package utils
| Packages are namespaces. They must be concise and descriptive.
|-
| Module
| N/A
| kebab-case (Lowercase with hyphens)
| github.com/user/my-project
| Used for import paths and module names. Kebab-case is standard for URLs.
|-
| Struct / Type
| Exported (Public)
| PascalCase
| type User struct
| Used to define public data structures.
|-
| Struct Field
| Exported (Public)
| PascalCase
| Name string
| Fields starting with a capital letter are visible outside the package.
|-
| Struct Field
| Unexported (Private)
| camelCase
| age int
| Fields starting with a lowercase letter are only visible within the package.
|-
| Function
| Exported (Public)
| PascalCase
| func GetUser() User
| Functions starting with a capital letter are public.
|-
| Function
| Unexported (Private)
| camelCase
| func internalHelper()
| Functions starting with a lowercase letter are private to the package.
|-
| Variable
| Exported (Public)
| PascalCase
| var MaxUsers int
| Variables starting with a capital letter are public.
|-
| Variable
| Unexported (Private)
| camelCase
| var count int
| Variables starting with a lowercase letter are private to the package.
|-
| Constant
| Exported (Public)
| ALL_CAPS
| const MaxUsers = 100
| Used for fixed, immutable values.
|-
| Interface
| Exported (Public)
| PascalCase
| type Reader interface
| Interfaces are typically named to describe the action they perform (e.g., Reader, Writer).
|-
| Method
| Exported/Unexported
| Follow Function Rules
| func (u *User) GetName() string
| Methods follow the same visibility rules as functions.
|}

Go/Quick Start

2026-07-27T02:52:23Z

Tacoball: /* naming convention table */

2026-07-21T14:47:13Z

Tacoball: /* Advanced practices */

== What's that? ==

Official Site: https://github.com/jrswab/axe

== Installation ==

=== Install ===

Set config dir first for NAS auto backup.

<syntaxhighlight lang="bash">
[System.Environment]::SetEnvironmentVariable('XDG_CONFIG_HOME', "$HOME\Documents\SynologyDrive\11.Environments", 'User')
</syntaxhighlight>

Reopen Power Shell to take effect.

<syntaxhighlight lang="bash">
go install github.com/jrswab/axe@latest
axe config init
</syntaxhighlight>

Then got this.

<syntaxhighlight lang="text">
....\Documents\SynologyDrive\11.Environments\axe
</syntaxhighlight>

=== Set VSCode as Editor for axe ===

Set environment variable '''EDITOR''' as

%USERPROFILE%\AppData\Local\Programs\Microsoft VS Code\Code.exe

Reopen PowerShell and execute to verify.

<syntaxhighlight lang="powershell">
# Varify environment variable
Get-ChildItem Env:EDITOR
</syntaxhighlight>

=== Set provider for local model ===

Then edit config.yoml.

<syntaxhighlight lang="bash">
# TODO: need to update
ii $HOME\AppData\Roaming\axe\config.toml
</syntaxhighlight>

It would be opened by VSCode.
Edit section '''providers.openai'''.

<syntaxhighlight lang="ini">
[providers.openai]
api_key = "sk-have-a-good-key"
base_url = "http://xxx.xxx.xxx.xxx:60000/v1"
</syntaxhighlight>

== Setup Agent ==

=== Add agent ===

<syntaxhighlight lang="bash">
axe agents init query
axe agents edit query
</syntaxhighlight>

<syntaxhighlight lang="ini">
model = "openai/google/gemma-4-E4B-qat-a4_0-gguf"
</syntaxhighlight>

=== Test agent ===

<syntaxhighlight lang="bash">
axe run query -p "1+1=?"
</syntaxhighlight>

If it outputs 2, axe is ready to use.

== Advanced practices ==

<pre>
# i-have-adhd
curl -sSL https://raw.githubusercontent.com/ayghri/i-have-adhd/main/SKILL.md -o adhd.md
# modern-go-guidelines
curl -sSL https://raw.githubusercontent.com/JetBrains/go-modern-guidelines/main/SKILL.md -o modern-go.md
# samber/cc-skills-golang
curl -sSL https://raw.githubusercontent.com/samber/cc-skills-golang/main/golang-security/SKILL.md -o go-security.md
curl -sSL https://raw.githubusercontent.com/samber/cc-skills-golang/main/golang-performance/SKILL.md -o go-perf.md
</pre>

<pre>
name = "go-developer"
description = "High-efficiency Go developer with gopls & golangci-lint execution capabilities"
model = "anthropic/claude-3-7-sonnet" # 或使用 open-ai/gpt-4o / ollama/qwen2.5-coder

skills = [
"~/.config/axe/skills/adhd.md",
"~/.config/axe/skills/modern-go.md",
"~/.config/axe/skills/go-security.md"
]

system_prompt = """
You are a senior Golang developer.
- You must strictly follow the i-have-adhd format: direct output, step-by-step with time estimates, and ending with a single Next Step.
- Before suggesting any refactoring, check for lint errors using golangci-lint.
- Write modern Go code (Go 1.21+) using standard libraries like `slices`, `cmp`, and proper error wrapping `fmt.Errorf("%w")`.
"""

[mcp_servers.gopls]
command = "gopls-mcp"
args = []

[tools]
file_read = true
file_write = true
bash_exec = true
</pre>

2026-07-21T02:34:40Z

Tacoball: /* review */

== Windows ==

=== general ===

{| class="wikitable"
! Purpose || Command
|-
| Install scoop ||
<syntaxhighlight lang="bash">
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
</syntaxhighlight>
|-
| Get path of an executable ||
<syntaxhighlight lang="bash">
gcm php
</syntaxhighlight>
Don't use '''where php''', it's very slow.
|}

=== winget ===

{| class="wikitable"
! Purpose || RunAs || Command
|-
| Install PowerShell || Required ||
<syntaxhighlight lang="bash">
winget install --id Microsoft.PowerShell --source winget --installer-type wix --override "CREATE_DESKTOP_SHORTCUT=1 ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL=1"
</syntaxhighlight>
Don't install '''with default options'''.
|-
| Update package list || ||
<syntaxhighlight lang="bash">
winget source update
</syntaxhighlight>
|}

=== scoop ===

{| class="wikitable"
! Purpose || RunAs || Command
|-
| Update package list || ||
<syntaxhighlight lang="bash">
scoop update
</syntaxhighlight>
|}

=== review ===

{| class="wikitable" style="text-align: center; width: 100%;"
|+ '''Windows Package Management Division Architecture'''
|- style="background-color: #eaecf0;"
! WinGet (For all GUI applications)
! Scoop (For all CLI & development tools)
|-
| style="vertical-align: top; text-align: left;" |
* Chrome / Edge
* VS Code / JetBrains
* Docker / Git
* Discord / Spotify
| style="vertical-align: top; text-align: left;" |
* PHP / Composer
* Node.js / NVM / Bun
* Python / Go / Rust
* Neovim / kubectl / 7zip
|}

== Ubuntu ==

{| class="wikitable"
! Purpose || Command
|-
| List how many top packages installed by me. ||
<syntaxhighlight lang="bash">
apt-mark showmanual | grep -E 'top$'
</syntaxhighlight>
|-
| List files owned by package ||
<syntaxhighlight lang="bash">
dpkg -L openvino-2026.2.1
</syntaxhighlight>
|-
| List all packages installed. ||
<syntaxhighlight lang="bash">
dpkg --get-selections
</syntaxhighlight>
|-
| Show version info of a package not installed. ||
<syntaxhighlight lang="bash">
sudo apt-cache show openssl
</syntaxhighlight>
|-
| Show version info of a package installed. ||
<syntaxhighlight lang="bash">
dpkg -s openssl | grep '^Version'
</syntaxhighlight>
|}

== OSX ==

{| class="wikitable"
! Purpose || Command
|-
| Install beta package ||
<syntaxhighlight lang="bash">
$ brew info jython
jython: stable 2.5.3, devel 2.7-b1
...
$ brew install --devel jython
</syntaxhighlight>
|-
| List compiling options of a package for brew install ||
<syntaxhighlight lang="bash">
# version / dependencies / build options
brew info graphviz

# build options only
brew options graphviz
</syntaxhighlight>
|-
| Remove unused packages. This action could make self-compiling executables miss link for libraries (*.so, *.dylib) ||
<syntaxhighlight lang="bash">
brew cleanup
brew cleanup $FORMULA
brew cleanup -n # dry-run
</syntaxhighlight>
|}

Useful Commands/Package Management

2026-07-21T02:34:04Z

Tacoball: /* review */

== Windows ==

=== general ===

{| class="wikitable"
! Purpose || Command
|-
| Install scoop ||
<syntaxhighlight lang="bash">
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
</syntaxhighlight>
|-
| Get path of an executable ||
<syntaxhighlight lang="bash">
gcm php
</syntaxhighlight>
Don't use '''where php''', it's very slow.
|}

=== winget ===

{| class="wikitable"
! Purpose || RunAs || Command
|-
| Install PowerShell || Required ||
<syntaxhighlight lang="bash">
winget install --id Microsoft.PowerShell --source winget --installer-type wix --override "CREATE_DESKTOP_SHORTCUT=1 ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL=1"
</syntaxhighlight>
Don't install '''with default options'''.
|-
| Update package list || ||
<syntaxhighlight lang="bash">
winget source update
</syntaxhighlight>
|}

=== scoop ===

{| class="wikitable"
! Purpose || RunAs || Command
|-
| Update package list || ||
<syntaxhighlight lang="bash">
scoop update
</syntaxhighlight>
|}

=== review ===

{| class="wikitable" style="text-align: center; width: 100%;"
|+ '''Windows 系統套件管理分工架構'''
|- style="background-color: #eaecf0;"
! WinGet (負責所有 GUI 應用)
! Scoop (負責所有 CLI 與開發工具)
|-
| style="vertical-align: top; text-align: left;" |
* Chrome / Edge
* VS Code / JetBrains
* Docker / Git
* Discord / Spotify
| style="vertical-align: top; text-align: left;" |
* PHP / Composer
* Node.js / NVM / Bun
* Python / Go / Rust
* Neovim / kubectl / 7zip
|}

== Ubuntu ==

{| class="wikitable"
! Purpose || Command
|-
| List how many top packages installed by me. ||
<syntaxhighlight lang="bash">
apt-mark showmanual | grep -E 'top$'
</syntaxhighlight>
|-
| List files owned by package ||
<syntaxhighlight lang="bash">
dpkg -L openvino-2026.2.1
</syntaxhighlight>
|-
| List all packages installed. ||
<syntaxhighlight lang="bash">
dpkg --get-selections
</syntaxhighlight>
|-
| Show version info of a package not installed. ||
<syntaxhighlight lang="bash">
sudo apt-cache show openssl
</syntaxhighlight>
|-
| Show version info of a package installed. ||
<syntaxhighlight lang="bash">
dpkg -s openssl | grep '^Version'
</syntaxhighlight>
|}

== OSX ==

{| class="wikitable"
! Purpose || Command
|-
| Install beta package ||
<syntaxhighlight lang="bash">
$ brew info jython
jython: stable 2.5.3, devel 2.7-b1
...
$ brew install --devel jython
</syntaxhighlight>
|-
| List compiling options of a package for brew install ||
<syntaxhighlight lang="bash">
# version / dependencies / build options
brew info graphviz

# build options only
brew options graphviz
</syntaxhighlight>
|-
| Remove unused packages. This action could make self-compiling executables miss link for libraries (*.so, *.dylib) ||
<syntaxhighlight lang="bash">
brew cleanup
brew cleanup $FORMULA
brew cleanup -n # dry-run
</syntaxhighlight>
|}

Useful Commands/Package Management

2026-07-21T02:32:04Z

Tacoball: /* OSX */

== Windows ==

=== general ===

{| class="wikitable"
! Purpose || Command
|-
| Install scoop ||
<syntaxhighlight lang="bash">
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
</syntaxhighlight>
|-
| Get path of an executable ||
<syntaxhighlight lang="bash">
gcm php
</syntaxhighlight>
Don't use '''where php''', it's very slow.
|}

=== winget ===

{| class="wikitable"
! Purpose || RunAs || Command
|-
| Install PowerShell || Required ||
<syntaxhighlight lang="bash">
winget install --id Microsoft.PowerShell --source winget --installer-type wix --override "CREATE_DESKTOP_SHORTCUT=1 ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL=1"
</syntaxhighlight>
Don't install '''with default options'''.
|-
| Update package list || ||
<syntaxhighlight lang="bash">
winget source update
</syntaxhighlight>
|}

=== scoop ===

{| class="wikitable"
! Purpose || RunAs || Command
|-
| Update package list || ||
<syntaxhighlight lang="bash">
scoop update
</syntaxhighlight>
|}

=== review ===

{| class="wikitable" style="text-align: center; width: 100%;"
|+ '''Windows 系統套件管理分工架構'''
|- style="background-color: #eaecf0;"
! style="width: 50%;" | WinGet (負責所有 GUI 應用)
! style="width: 50%;" | Scoop (負責所有 CLI 與開發工具)
|-
| style="vertical-align: top; text-align: left;" |
* Chrome / Edge
* VS Code / JetBrains
* Docker / Git
* Discord / Spotify
| style="vertical-align: top; text-align: left;" |
* PHP / Composer
* Node.js / NVM / Bun
* Python / Go / Rust
* Neovim / kubectl / 7zip
|}

== Ubuntu ==

{| class="wikitable"
! Purpose || Command
|-
| List how many top packages installed by me. ||
<syntaxhighlight lang="bash">
apt-mark showmanual | grep -E 'top$'
</syntaxhighlight>
|-
| List files owned by package ||
<syntaxhighlight lang="bash">
dpkg -L openvino-2026.2.1
</syntaxhighlight>
|-
| List all packages installed. ||
<syntaxhighlight lang="bash">
dpkg --get-selections
</syntaxhighlight>
|-
| Show version info of a package not installed. ||
<syntaxhighlight lang="bash">
sudo apt-cache show openssl
</syntaxhighlight>
|-
| Show version info of a package installed. ||
<syntaxhighlight lang="bash">
dpkg -s openssl | grep '^Version'
</syntaxhighlight>
|}

== OSX ==

{| class="wikitable"
! Purpose || Command
|-
| Install beta package ||
<syntaxhighlight lang="bash">
$ brew info jython
jython: stable 2.5.3, devel 2.7-b1
...
$ brew install --devel jython
</syntaxhighlight>
|-
| List compiling options of a package for brew install ||
<syntaxhighlight lang="bash">
# version / dependencies / build options
brew info graphviz

# build options only
brew options graphviz
</syntaxhighlight>
|-
| Remove unused packages. This action could make self-compiling executables miss link for libraries (*.so, *.dylib) ||
<syntaxhighlight lang="bash">
brew cleanup
brew cleanup $FORMULA
brew cleanup -n # dry-run
</syntaxhighlight>
|}