@fmatar/ archlens- skill (英语)

零依赖CLI、政策脚手架和多代理技术安装器 Archlens 动态清洁建筑工作台。 。 。 .

分析任何项目寄存器,检测编程语言和软件包等级,将软件包分类为同心同心的 Clean Architecture 阶梯,脚手架 .archlens/policy.json,并装备了AI编码助理(Claude Code,双子座CLI,Google Antigravity)的邮箱重构协议.

QQ 快速启动

备选办法A:零出入口自主AI设置(--mcp - 关于抗重力和克洛德的建议)

设备 谷歌反重力, (中文(简体) ), 克劳德代码, (中文(简体) ), 克劳德桌面, (中文(简体) ), 光标, (中文(简体) ), 风起浪起,以及 双子座CLI 在一个命令。 选择可移植的 NPX stdio 桥( 带有 4- 等离线 AST 倒置) 或 麻黄多克 mcp-stdio 容器 :

# Portable / shared-repo setup (.archlens/policy.json + AGENTS.md + skills + NPX MCP bridge):
npx @fmatar/archlens-skill --yes --skills --mcp

# Personal workstation setup (ephemeral docker run -i --rm -e QUARKUS_PROFILE=mcp-stdio container):
npx @fmatar/archlens-skill --yes --skills --mcp --docker

# Equip global skills AND global MCP manifests across all detected coding agents:
npx @fmatar/archlens-skill global
npx @fmatar/archlens-skill global --docker

备选办法B:直接通过 npx skills

打开 Vercel实验室技能 标准,您可以添加跨越 15+ AI 编码助理(Claude Code, Cursor, Antigravity, Copilot, Codex, Windsurf, Zed)的Archlens 能力 :

# Add all 3 Archlens skills to detected AI assistants in project or globally:
npx skills add fmatar/archlens --all -y

# Or add to a specific assistant:
npx skills add fmatar/archlens --all --agent claude-code -y

选项 C: 通过 NPX 运行交互式政策脚手架

# Production Stable (recommended)
npx @fmatar/archlens-skill

# Canary / Development Preview (tracks latest develop branch)
npx @fmatar/archlens-skill@dev

# Direct GitHub Execution (zero registry dependencies)
npx github:fmatar/archlens

备选办法D:通过国家预防机制在全球安装

npm install -g @fmatar/archlens-skill
archlens-skill

选项 E: 从本地仓库克隆运行

# Install globally from the local repository:
npm install -g ./cli
archlens-skill

# Or execute directly with Node:
node ./cli/bin/index.js

关键特性

• 无外部依赖: 配备纯节点Js标准库的工程师(node:fs, (中文(简体) ), node:path, (中文(简体) ), node:readline, (中文(简体) ), node:test, (中文(简体) ), node:os) (中文(简体) ). 立即执行通过 npx 没有后遗症.
• 交互式终端 UI:在终端运行时显示有样式的ANSI诊断,ASCII品牌标语,以及交互式引导选择.
• Polyglot 密码库分析器:自动检测项目语言和布局跨越了Java,克特林,TypeScript,JavaScript,Python,Rust,Go和克洛朱尔.
• 同心分级分类: 自动将软件包映射到清洁建筑层:
  • 0级(核心领域)数字 : domain, (中文(简体) ), model, (中文(简体) ), entities, (中文(简体) ), core, (中文(简体) ), types
  • 1级(应用)数字 : usecase, (中文(简体) ), application, (中文(简体) ), service, (中文(简体) ), port, (中文(简体) ), interactor
  • 第二级(配位符)数字 : adapter, (中文(简体) ), controller, (中文(简体) ), gateway, (中文(简体) ), presenter, (中文(简体) ), repository, (中文(简体) ), dto, (中文(简体) ), api
  • 第三级(基础设施)数字 : infrastructure, (中文(简体) ), config, (中文(简体) ), db, (中文(简体) ), web, (中文(简体) ), server, (中文(简体) ), client
• 多机构技能部署: 安装 archlens-install-policy 将全球技能纳入克洛德守则~/.claude/skills/),双子CLI / 抗重力 (~/.gemini/config/skills/)和自定义代理工作空间.
• 安全递增更新: 为新引入的软件包重新扫描代码库, 更新 order 财务报告和审定财务报表 levels 同时保留用户自定义规则和配置.
• 无缝升级迁移: 自动迁移遗产 .uml-viewer/ 现代文件夹和配套文件 .archlens/ 通过 archlens-skill upgrade。 。 。 .
• 模式背景协议( MCP) 客户端自动配置: 检测和配置主机AI客户端在单一命令(Claude Desktop, Google Antigravity, Claude Code, Cursor, VS Code)中的显示(Claude)--mcp) (中文(简体) ).
• 紧急集装箱管弦乐和斯德奥桥: 必要时自动旋转Archlens容器,将MCP接通于 stdio(mcp 命令),并在无法使用多克时提供即时离线AST倒置.
• 邮箱协议集成: 将清洁建筑配套协议注入 CLAUDE.md 财务报告和审定财务报表 AGENTS.md 用于无缝同步的邮箱重构(to-agent.json, (中文(简体) ), to-viewer.json) (中文(简体) ).

使用和CLI 参考

共同工作流程

1. 互动设置向导

通过仓库检查和选项选择指导您 :

npx @fmatar/archlens-skill

2. 无头本地初始化

以默认设置初始化当前寄存器中的 Clean 架构治理 :

npx @fmatar/archlens-skill --yes

瞄准特定寄存器目录 :

npx @fmatar/archlens-skill --path /path/to/project --yes

3. 全球AI代理技术与MCP安装

部署技能和全球MCP的显示方式是:Claude Code、双子座CLI和Antigravity在所有工作空间配备(通过) --docker 用于电子容器模式或 --no-mcp 以跳过 MCP 设置 :

npx @fmatar/archlens-skill global
npx @fmatar/archlens-skill global --docker

4. 同步现有政策

添加新模块或软件包后重新扫描代码以将其纳入 .archlens/policy.json数字 :

npx @fmatar/archlens-skill update

5. 更新遗产配置

长者 .uml-viewer/ 标准目录和相伴 .archlens/ 版式 :

npx @fmatar/archlens-skill upgrade

6. 导出 LLM 重构快取

生成 Claude Code、双子座、ChatGPT 或 Antigravity 的可复制的建筑诊断和具体依赖性倒置原则(DIP)指令:

# Print dossier to stdout
npx @fmatar/archlens-skill prompt

# Or copy directly to system clipboard
npx @fmatar/archlens-skill prompt --copy

7. 示范背景协议(MCP)设置和Stio桥

配置检测到的AI客户端显示或发射交互式 stdio 桥:

# Auto-configure Claude Desktop, Google Antigravity, Claude Code, Cursor, and VS Code
npx @fmatar/archlens-skill --mcp

# Auto-configure pure ephemeral Docker MCP container (docker run -i --rm -e QUARKUS_PROFILE=mcp-stdio)
npx @fmatar/archlens-skill --mcp --docker

# Launch MCP stdio transport bridge (spins up Docker container automatically when needed)
npx @fmatar/archlens-skill mcp

8. 启动工作台集装箱和自动储存

启动 Archlens 容器,挂载工作空间,验证准备状态,并选择打开浏览器. 如果容器被杀死或停止,则运行 start (或呼叫 MCP 工具) 自动再次启动 :

# Start container and automatically open workbench in browser:
npx @fmatar/archlens-skill start --open

# Start container in background on default port 8088:
npx @fmatar/archlens-skill start

# Specify a custom port or target workspace directory:
npx @fmatar/archlens-skill start --path /path/to/project --port 8088 --open

命令行选项

* * 人工生成

运行安装器会创建以下治理结构:

my-project/
├── .archlens/
│   ├── policy.json             # Clean Architecture concentric tiers & rules
│   └── workbench.config.json   # Workbench endpoint and mailbox IPC configuration
├── CLAUDE.md                   # Clean Architecture Mailbox companion protocol
└── AGENTS.md                   # Agent instructions for DIP refactoring & AST reload

在 Archlens 工作区可视化

一旦配置, 启动 Archlens 工作台并打开您的项目 :

http://localhost:8088/?projectRoot=/absolute/path/to/my-project

或者打开视觉工作台并按下 ⌘O 编号 : Ctrl+O 浏览并选择您的工程根.

测试

使用节点本地测试跑道执行测试套件 :

npm test

许可证

阿帕奇-2.0 © 法迪马达