ccg-workflow 开发语言能力中枢：多语言技能矩阵与语言选型实战指南

ccg-workflow 在安装时会向 Claude 等 AI 客户端部署一套domains/development领域技能，其入口 SKILL.md 是一份"开发语言能力索引"：它用一张能力矩阵将 Python、Go、Rust、TypeScript、Java、C/C++、Shell 七种语言的实战技能文件组织起来，并用一份语言选型指南指导 Agent 在不同业务场景下快速选型。本文以该索引文档为主体，结合仓库内的技能路由规则、技能注册机制与安装实现，完整讲解这套多语言技能体系的结构、路由原理与使用方式，读完即可理解 CCG 如何"按语言分发领域知识"，并能在此基础上扩展新的语言技能。

一、development 领域在 CCG 技能体系中的定位

在 ccg-workflow 中，domains/目录承载的是"知识型技能"（knowledge skill）：与带可执行脚本的tools/工具技能不同，这类技能以 Markdown 秘典文件的形式沉淀某一领域的专家知识，供 Agent 在响应前按需读取。domains/development/正是其中的语言开发域，其入口文档通过 frontmatter 声明了自己的身份：

name: development description: 开发语言能力索引。Python、Go、Rust、TypeScript、Java、C++、Shell。当用户提到编程、开发、代码、语言时路由到此。 license: MIT user-invocable: false disable-model-invocation: false

这几个字段在仓库的 skill-registry.ts 中都有对应的解析逻辑：

• name必须是 kebab-case 形式的 slug（/^[a-z0-9]+(?:-[a-z0-9]+)*$/），用于技能去重与命令命名；
• description是路由判定的核心信号，Agent 依据它判断"用户提到编程、开发、代码、语言时路由到此"；
• user-invocable: false表示该技能不生成独立的斜杠命令，它只作为索引入口，由上层路由规则按需读取——这与tools/下那些user-invocable: true的可执行技能（如verify-security）有本质区别；
• disable-model-invocation: false允许模型在匹配到关键词时主动调用该技能。

二、能力矩阵：七种语言的技能索引

SKILL.md 的核心是一张能力矩阵表，将七种语言的技能文件、目标语言与核心能力一一对应。这份表格是"开发语言能力中枢"的骨架，完整内容如下：

每一份被索引的语言技能文件都遵循相同的知识组织范式：先声明自己的 frontmatter（name、description），随后按"语言特性 → 框架实战 → 并发/异步 → 测试 → 项目结构 → 常用库"的脉络展开，确保 Agent 在动手写代码前能快速取用该语言的最佳实践。能力矩阵的价值在于：Agent 只需命中一次development路由，就能通过这张表找到当前编程语言对应的完整秘典。

三、语言选型指南：场景化决策速查

SKILL.md 的另一半核心内容是内置在文档中的语言选型指南（YAML 格式）。它把常见的业务场景映射到推荐语言与技术栈上，让 Agent 在需求阶段就能给出不偏离行业惯例的选型建议。完整内容如下：

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

这份指南本身是"意见性知识"，与技能文件中可验证的代码片段互为补充：选型指南负责"选什么"，语言秘典负责"怎么写"。例如指南建议高并发后端选 Go（Gin/Echo），而 go.md 中就直接给出了 Gin 的路由组、中间件、ShouldBindJSON参数绑定等可复制代码；指南建议前端 SPA 选 TypeScript + React/Vue，对应的 typescript.md 则完整覆盖了函数组件、Hooks、Composition API 与测试写法。

四、七份语言技能文件的内容纵深

能力矩阵索引到的每一份语言秘典都是可独立阅读的实战手册，下文逐一对齐其核心知识板块，便于读者在路由命中后快速定位所需章节。

4.1 Python：FastAPI 优先的 Web 与数据处理

python.md 的 frontmatter 声明了路由关键词：Python、Django、Flask、FastAPI、pytest、pandas。其内容覆盖：

• Web 框架：以 FastAPI 为推荐项，给出 Pydantic 模型、Depends依赖注入、async handler 的标准写法；同时提供 Flask 路由与错误处理器、Django 的 Model/View/URL 三段式示例；
• 异步编程：asyncio.gather并发抓取的标准范式；
• 数据处理：pandas 的读取、清洗（dropna/drop_duplicates）、聚合（groupby().agg()）与导出全流程；
• 测试与 CLI：pytest 的参数化、fixture、mock、异步测试，以及pytest --cov等运行参数；CLI 同时给出 Typer（推荐）与 argparse 两种方案；
• 工程化：标准src/项目结构 +pyproject.toml（含 pytest 路径与 ruff 配置）。

4.2 Go：Gin/Echo 与并发原语

go.md 的 frontmatter 声明路由关键词：Go、Golang、Gin、Echo、goroutine。其内容覆盖：

• Web 框架：Gin 的中间件、路由组与 binding 校验（binding:"required,email"），Echo 的等价实现；
• 并发编程：goroutine + channel 的 worker 池、sync.WaitGroup并行抓取、context.WithTimeout超时控制——这是高并发后端选型 Go 的底层依据；
• 错误处理：errors.New哨兵错误、fmt.Errorf("...: %w", err)错误包装、errors.Is判断的完整链路；
• 测试：表驱动测试、assert断言与 Benchmark，配套go test -race竞态检测命令；
• CLI：Cobra 的命令注册与IntP标志绑定，以及标准cmd/+internal/项目结构。

4.3 Rust：所有权、Tokio 与 Axum

rust.md 的 frontmatter 声明路由关键词：Rust、Cargo、tokio、内存安全。其内容覆盖：

• 所有权系统：移动、借用、可变借用的代码级演示；
• 异步编程：#[tokio::main]、join_all并发、mpsc::channel消息传递；
• Web 框架：Axum 的路由与Path提取器、Actix-web 的等价实现；
• CLI 与测试：Clap 的 derive 宏（含#[arg(short, long, default_value = "8080")]）、#[cfg(test)]单元测试与#[tokio::test]异步测试；
• 工程化：标准src/+tests/+benches/结构。

4.4 TypeScript：前后端一体的完整链路

typescript.md 的 frontmatter 声明路由关键词：TypeScript、JavaScript、Node、React、Vue、Next.js。其内容覆盖：

• 类型系统：接口、类型别名、字面量联合类型、泛型与Partial/Required/Pick/Omit工具类型的实现原理；
• Node.js 后端：Express 的中间件、路由与错误处理，Fastify 的异步 handler 写法；
• 前端框架：React 函数组件 +useState/useEffect/useCallback，自定义useFetch<T>Hook；Vue 3 的<script setup lang="ts">组合式 API（defineProps/defineEmits/computed）；
• 测试：Vitest + Testing Library 的渲染断言、事件触发与vi.mock；
• 工程化：标准src/分层结构（components/hooks/services/types/utils）与常用库速查表（Express/Fastify、Next.js/Nuxt、Prisma、Zod 等）。

4.5 Java：Spring Boot 企业级开发

java.md 的 frontmatter 声明路由关键词：Java、Spring、Maven、Gradle、JVM。其内容覆盖：

• Spring Boot 分层：Controller / Service / Repository 三层架构，JPA 派生的查询方法（findByEmail）；
• Entity 与 DTO：JPA 注解映射、@Valid校验注解；
• 配置：application.yml的数据源、JPA（ddl-auto: update）、日志级别配置；
• 异常处理：@RestControllerAdvice全局异常处理与自定义异常；
• 测试：@SpringBootTest+ MockMvc 的集成测试、Mockito 的单元测试。

4.6 C/C++：现代 C++ 与性能工程

cpp.md 的 frontmatter 声明路由关键词：C、C++、CMake、内存、指针。其内容覆盖：

• 现代 C++：unique_ptr/shared_ptr/weak_ptr智能指针、C++20 Ranges、Lambda 捕获语义；
• 并发：std::thread、lock_guard、std::async、条件变量；
• 内存安全：RAII 封装FileHandle示例，以及 AddressSanitizer、Valgrind、clang-tidy 等检查工具链；
• CMake：add_executable/add_library/find_package与构建测试流程；
• 测试：Google Test 的EXPECT_EQ/EXPECT_THROW与 TestFixture。

4.7 Shell：Bash 自动化与系统管理

shell.md 的 frontmatter 声明路由关键词：Shell、Bash、脚本、自动化、Linux命令。其内容覆盖：

• Bash 基础：字符串操作、数组、条件判断、循环与函数；
• 实用脚本模板：带参数解析（-o/-v/-h）的健壮脚本、彩色日志函数、set -euo pipefail+ trap 错误处理；
• 常用命令组合：grep/sed/awk 文本处理、find 批量操作、curl 网络请求；
• 最佳实践：set -euo pipefail、变量加引号、[[ ]]与$()优先、command -v检查工具存在性。

五、路由机制：Agent 如何命中 development 技能

技能索引本身不主动运行，触发它的是仓库内置的领域路由规则 ccg-skill-routing.md。该文件为 Development Domain 定义了与语言秘典一一对应的路由表：

路由规则强调"关键词匹配是模糊的，按意图而非精确字符串匹配"；当请求跨多个领域时允许同时读取多份技能文件；并且技能文件优先于模型训练数据——只要存在对应的语言秘典，就不得仅凭训练记忆编造领域知识。对 development 域而言，最典型的路由动作是"自动从文件扩展名或上下文检测编程语言，然后读取对应的 development 技能文件"。这保证了 CCG 在多模型协作执行（Codex + Gemini + Claude）时，无论哪个模型接手编程任务，都能先获得该语言的专家级上下文。

六、安装、运行与扩展

6.1 安装流程与安全裁剪

development 技能随 ccg-workflow 初始化自动安装。安装器 installer.ts 将templates/skills/整体递归复制到~/.claude/skills/ccg/（overwrite: true保证每次安装均为最新），随后对复制的.md文件做~路径模板替换，并校验至少存在一个SKILL.md。值得注意的细节是：安装器会默认删除domains/security目录——因为红队/渗透测试内容可能触发杀毒软件误报，需要安全技能的开发者可手动执行cp -r $(npm root -g)/ccg-workflow/templates/skills/domains/security/ ~/.claude/skills/ccg/domains/security/恢复。而domains/development属常规开发知识，始终随默认安装保留。

更新技能同样通过npx ccg-workflow update或重新执行npx ccg-workflow完成；卸载时安装器只清理skills/ccg/目录，不触碰用户自建的技能。

6.2 运行时读取路径

安装完成后，技能秘典的读取路径为~/.claude/skills/ccg/domains/development/*.md。路由规则文件ccg-skill-routing.md同时会被安装到 Claude 的规则目录（见 installer.ts 中的规则文件清单），从而在每次会话中生效。

对于user-invocable: true的技能，安装器还会通过 skill-registry.ts 自动生成~/.claude/commands/ccg/{name}.md斜杠命令：知识型技能生成"读取秘典并遵照执行"的指令，脚本型技能则通过统一入口node ~/.claude/skills/ccg/run_skill.js <skill-name> [args...]执行（该入口实现了基于目标路径 MD5 的文件锁，避免并发执行冲突）。development由于user-invocable: false，不生成命令，只作为被路由读取的知识源。

6.3 新增一种语言技能

从源码结构可以推断，向能力矩阵扩展新语言只需三步：在 templates/skills/domains/development/ 下新增xxx.md（含name/descriptionfrontmatter，按"语言特性 → 框架 → 并发 → 测试 → 项目结构 → 常用库"组织内容）；在 SKILL.md 的能力矩阵表中登记一行（Skill / 语言 / 核心能力）；在 ccg-skill-routing.md 的 Development Domain 路由表中补充 Language → Skill File 映射。安装器会递归复制整个templates/skills/目录，因此新文件会在下一次初始化或update时自动生效，无需改动安装代码。

七、小结

domains/development/SKILL.md是 ccg-workflow 多语言开发能力的总控索引：能力矩阵让 Agent 在七种语言之间精确取用专家秘典，语言选型指南让需求阶段的选型决策有据可依，二者配合路由规则与安装机制，构成了一套"按语言分发、按需读取、随装随用"的领域知识闭环。无论是让 Claude/Codex 编写 Go 高并发服务、Rust 系统组件，还是让 Gemini 完成 TypeScript 前端与 Shell 运维脚本，这套技能体系都能在动手之前，先把对应语言的工程化最佳实践注入模型上下文。