docs: add command-line tools reference (hvigorw, codelinter, hstack)

arkts-development/SKILL.md

@@ -141,11 +141,145 @@ ArkTS enforces stricter rules than TypeScript for performance and safety:
 
 See [references/migration-guide.md](references/migration-guide.md) for complete TypeScript → ArkTS migration details.
 
+## Command Line Build (hvigorw)
+
+hvigorw is the Hvigor wrapper tool for command-line builds.
+
+```bash
+# Common build tasks
+hvigorw clean                              # Clean build directory
+hvigorw assembleHap -p buildMode=debug     # Build Hap (debug)
+hvigorw assembleApp -p buildMode=release   # Build App (release)
+hvigorw assembleHar                        # Build Har library
+hvigorw assembleHsp                        # Build Hsp
+
+# Build specific module
+hvigorw assembleHap -p module=entry@default --mode module
+
+# Run tests
+hvigorw onDeviceTest -p module=entry -p coverage=true
+hvigorw test -p module=entry              # Local test
+
+# CI/CD recommended
+hvigorw assembleApp -p buildMode=release --no-daemon
+```
+
+Common parameters:
+
+| Parameter | Description |
+|-----------|-------------|
+| `-p buildMode={debug\|release}` | Build mode |
+| `-p product={name}` | Target product (default: default) |
+| `-p module={name}@{target}` | Target module (with `--mode module`) |
+| `--no-daemon` | Disable daemon (recommended for CI) |
+| `--analyze=advanced` | Enable build analysis |
+| `--optimization-strategy=memory` | Memory-optimized build |
+
+See [references/hvigor-commandline.md](references/hvigor-commandline.md) for complete command reference.
+
+## Code Linter (codelinter)
+
+codelinter is the code checking and fixing tool for ArkTS/TS files.
+
+```bash
+# Basic usage
+codelinter                           # Check current project
+codelinter /path/to/project          # Check specified project
+codelinter -c ./code-linter.json5    # Use custom rules
+
+# Check and auto-fix
+codelinter --fix
+codelinter -c ./code-linter.json5 --fix
+
+# Output formats
+codelinter -f json -o ./report.json  # JSON report
+codelinter -f html -o ./report.html  # HTML report
+
+# Incremental check (Git changes only)
+codelinter -i
+
+# CI/CD with exit codes
+codelinter --exit-on error,warn      # Non-zero exit on error/warn
+```
+
+| Parameter | Description |
+|-----------|-------------|
+| `-c, --config <file>` | Specify rules config file |
+| `--fix` | Auto-fix supported issues |
+| `-f, --format` | Output format: default/json/xml/html |
+| `-o, --output <file>` | Save result to file |
+| `-i, --incremental` | Check only Git changed files |
+| `-p, --product <name>` | Specify product |
+| `-e, --exit-on <levels>` | Exit code levels: error,warn,suggestion |
+
+See [references/codelinter.md](references/codelinter.md) for complete reference.
+
+## Stack Trace Parser (hstack)
+
+hstack parses obfuscated crash stacks from Release builds back to source code locations.
+
+```bash
+# Parse crash files directory
+hstack -i crashDir -o outputDir -s sourcemapDir -n nameCacheDir
+
+# Parse with C++ symbols
+hstack -i crashDir -o outputDir -s sourcemapDir --so soDir -n nameCacheDir
+
+# Parse single crash stack
+hstack -c "at func (entry|entry|1.0.0|src/main/ets/pages/Index.ts:58:58)" -s sourcemapDir
+```
+
+| Parameter | Description |
+|-----------|-------------|
+| `-i, --input` | Crash files directory |
+| `-c, --crash` | Single crash stack string |
+| `-o, --output` | Output directory (or file with `-c`) |
+| `-s, --sourcemapDir` | Sourcemap files directory |
+| `--so, --soDir` | Shared object (.so) files directory |
+| `-n, --nameObfuscation` | NameCache files directory |
+
+Requirements:
+- Must provide either `-i` or `-c` (not both)
+- Must provide at least `-s` or `--so`
+- For method name restoration, provide both `-s` and `-n`
+
+See [references/hstack.md](references/hstack.md) for complete reference.
+
+## Code Obfuscation (ArkGuard)
+
+Enable in `build-profile.json5`:
+
+```json
+"arkOptions": {
+  "obfuscation": {
+    "ruleOptions": {
+      "enable": true,
+      "files": ["./obfuscation-rules.txt"]
+    }
+  }
+}
+```
+
+Common rules in `obfuscation-rules.txt`:
+
+```text
+-enable-property-obfuscation      # Property name obfuscation
+-enable-toplevel-obfuscation      # Top-level scope obfuscation
+-enable-filename-obfuscation      # Filename obfuscation
+-keep-property-name apiKey        # Whitelist specific names
+```
+
+See [references/arkguard-obfuscation.md](references/arkguard-obfuscation.md) for complete guide.
+
 ## Reference Files
 
 - **Migration Guide**: [references/migration-guide.md](references/migration-guide.md) - Complete TypeScript to ArkTS migration rules and examples
 - **Component Patterns**: [references/component-patterns.md](references/component-patterns.md) - Advanced component patterns and best practices
 - **API Reference**: [references/api-reference.md](references/api-reference.md) - Common HarmonyOS APIs
+- **ArkGuard Obfuscation**: [references/arkguard-obfuscation.md](references/arkguard-obfuscation.md) - Code obfuscation configuration and troubleshooting
+- **Hvigor Command Line**: [references/hvigor-commandline.md](references/hvigor-commandline.md) - Complete hvigorw build tool reference
+- **CodeLinter**: [references/codelinter.md](references/codelinter.md) - Code checking and fixing tool
+- **Hstack**: [references/hstack.md](references/hstack.md) - Crash stack trace parser for Release builds
 
 ## Development Environment