jarekbird/code-factory

# Code Factory — Claude Code 技能 一种与语言和框架无关的 **Claude Code 技能**，可在任何项目中安装完整的 AI 辅助工程系统。 **在将以下内容放入 `~/.claude/skills/code-factory/` 后，通过 `/code-factory` 调用**（在 Claude Code 中）。 ## 安装内容 三层约束机制应用于任何项目： 1. **CLAUDE.md + `engineer` 技能** — 架构约定与建议 2. **AI 审查技能** — 对每个 Claude 响应进行 LLM 级别检查（停止机制）： - `complexity-check` — 静态规则检查 + LLM 大 O 推理 - `srp-check` — 单一职责原则审查 - `dry-check` — 通过 voyage-code-3 嵌入与 pgvector 检测语义重复 - `benchmark` — 经验复杂度验证（手动） 3. **确定性钩子** — 无法忽略的 Shell/脚本约束： - PreToolUse：架构边界检查（例如引擎不能导入 ORM） - PostToolUse：自动格式化与 Lint 修复，异步嵌入索引更新 - Stop：运行 4 个 AI 检查代理 附加内容： - `.claude/whitelist.yaml` 用于可接受的违规项（复杂度/SRP/DRY） - 代码工厂技能（`new-model`、`new-step`）用于脚手架生成 - voyage-code-3 语义重复检测 ## 结构 ``` code-factory/ ├── SKILL.md # The installer (6-phase workflow) ├── templates/ # Language-agnostic specs + skills │ ├── benchmark.md │ ├── check-imports.spec.md │ ├── code-embeddings.spec.md │ ├── complexity-check.md │ ├── dry-check.md │ ├── engineer.spec.md │ ├── factory-skills.spec.md │ ├── settings.spec.md │ ├── srp-check.md │ └── whitelist.yaml └── references/ # Concrete implementations └── python-litestar/ # Full working Python/Litestar example ├── check-imports.sh ├── code_embeddings.py ├── engineer.md ├── new-model.md ├── new-step.md ├── settings.json └── whitelist.py ``` **规范文件与具体文件的区别：** - `templates/*.spec.md` 描述要构建的内容（与语言无关） - `templates/*.md`（检查技能 + whitelist.yaml）是纯 LLM 提示或格式定义 — 请原样复制 - `references//` 是可用于模式匹配的具体工作示例 ## 安装 ``` git clone https://github.com/jarekbird/code-factory.git ~/.claude/skills/code-factory ``` ## 要求 - **Claude Code**（Anthropic CLI） - **`/research` 技能**（用于语言特定工具发现）— 属于个人助理插件，或任何多源搜索技能 - **VOYAGE_API_KEY** 环境变量（用于 DRY 检查；[voyage.ai](https://voyage.ai)） - 语言特定的包管理器（按项目自动检测） - 嵌入功能：若使用参考 Python 实现，需 Postgres + pgvector ## 用法 在任何项目中： ``` /code-factory # Fresh install /code-factory --update # Re-sync after code changes /code-factory --minimal # Skip embeddings setup ``` 安装流程： 1. 检测语言与框架 2. 使用 `/research` 查找 Ruff、import-linter、tree-sitter 语法与 voyage-code-3 集成的语言特定等价项 3. 在目标项目中搭建 `.claude/skills/`、`.claude/hooks/` 和 `.claude/settings.json` 4. 通过项目包管理器安装依赖 5. 运行静态检查进行验证 ## 添加新的参考实现 在新栈（TS/Go/Rust 等）上安装并验证后，将生成的文件复制回 `references//` 并提交 PR — 有助于后续相同栈的安装跳过调研阶段。 ## 许可证 MIT

标签：AI审查, AI工程化, AI辅助编程, Claude Code, pgvector, SEO: AI代码助手, SEO: Claude技能, SEO: 代码工厂, SEO: 工程化AI, Shell脚本, SOC Prime, voyage-code-3, 云安全监控, 代码白名单, 代码规范, 单一职责原则, 可视化界面, 后工具使用, 向量嵌入, 复杂度分析, 大O复杂度, 开发工具, 技术栈, 技能插件, 日志审计, 架构约束, 框架无关, 测试用例, 确定性钩子, 自动格式化, 语义重复检测, 语言无关, 逆向工具, 静态分析, 预工具使用