# @aisdlc/cli 中文文档

规范地址：https://npmcn.com/package/%40aisdlc/cli/

版本：3\.2\.0
npm 元数据更新时间：2026-11-04T18:24:46.924Z
中文译文更新时间：2026-11-06T07:37:21.882Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aisdlc/cli
原文对照：https://npmcn.com/package/%40aisdlc/cli/?lang=original
项目主页：https://github.com/altromon/AI-SDLC#readme
源码仓库：https://github.com/altromon/AI-SDLC

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：375 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-10-02T09:55:48.731Z
- 最新版本发布：2026-11-04T18:24:46.557Z
- 近 30 天下载量：4118（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 29 个）

## 中文简介

AI-SDLC 质量门、治理和脚手架的指令行界面

## 安装

```sh
npm install @aisdlc/cli
```

也可以使用：`pnpm add @aisdlc/cli`、`yarn add @aisdlc/cli`、`bun add @aisdlc/cli`

## README

# @aisdlc/ cli (英语)

命令行接口 **大赦国际-SDLC**,用于受管,可追踪,质量驱动的AI辅助软件工程的AI-原生软件开发生命周期框架.

## 什么是AI-SDLC? (英语)?

AI-SDLC是将AI纳入软件开发生命周期同时维持工程纪律的框架.

它将AI协助发展与下列做法结合起来:

-   要求和规格
-   改革管理
-   核查
-   质量门
-   可追踪性
-   工程 KPIs
-   基于 Git 的工作流程
-   代理工程
-   MCP一体化

CLI为这些能力提供主指令行入站.

## 安装

### 全球安装

```bash
npm install -g @aisdlc/cli
```

然后说:

```bash
aisdlc --help
```

### 当地安装

```bash
npm install @aisdlc/cli
```

或者说:

```bash
pnpm add @aisdlc/cli
```

## 快开始

安装后运行 :

```bash
aisdlc --help
```

CLI提供覆盖AI-SDLC生命周期不同部分的命令.

## 图标

这个 `aisdlc` CLI在AI-SDLC生命周期的6个功能类别中提供全面指令:

### 1\. 项目初始化和工作流程

| 命令 | 说明 | 密钥选项 |
| --- | --- | --- |
| `aisdlc init [directory]` | Bootstraps 拥有 AI-SDLC 文件夹的寄存器,全部34 Cononical JSON schemas(2020-12草案),38个基础启动模板(生产,安全,隐私,安全,手册,遵守,SDD,CI),Pull Request模板,政策(`quality-policy.yaml`, (中文(简体) ), `license-policy.yaml`, (中文(简体) ), `privacy-policy.yaml`),以及AI代理配置(11个专业代理). 无条件生成通用的 MCP 配置(`antigravity.mcp.json`, (中文(简体) ), `.vscode/mcp.json`, (中文(简体) ), `.cursor/mcp.json`) (中文(简体) ). 无损地向消费者注入标准 npm 脚本 `package.json`。在交互式 TTY 模式下,为 CI/CD 提供者、架构级别和 AI 代理目标提供提示. | `-d, --dry-run`, (中文(简体) ), `--ci <github|gitlab|azure|bitbucket|none>`, (中文(简体) ), `--agents <all|cursor|claude|antigravity|copilot|mcp|none>`, (中文(简体) ), `--arch <minimal|full|none>`, (中文(简体) ), `--json`, (中文(简体) ), `-F, --format <format>` |
| `aisdlc check` | 统一飞行前大门:使用可选自动修理(同步Gherkin至)进行质量门检查 `.feature` 并重新计算PDAC SHA-256摘要. | `--fix`, (中文(简体) ), `-r, --root <path>`, (中文(简体) ), `--json`, (中文(简体) ), `-F, --format <format>` |
| `aisdlc mcp` | 启动本地模式上下文协议服务器 `stdio` 披露24个决定性工具和6个背景资源. | `-r, --root <path>` |

#### 存储器启动( R)`aisdlc init`(中文(简体) )

运行 `aisdlc init` (或 `npx @aisdlc/cli init`提供统包治理环境:

1.  **交互式引导提示( TTY 模式)**数字 :
    -   **CI/CD 供应商**: GitHub 动作 (默认/ 建议), GitLab CI, Azure DevOps 管道, Bitbucket 管道, 或者无.
    -   **建筑外观**: 最小/基线( 默认值 : `ARCH-INTRO-*`, (中文(简体) ), `CMP-*`, (中文(简体) ), `ADR-*`),全(全部为12个弧度42节),或无.
    -   **AI 代理人**: All (Cursor, Claude Code, Antigravity, Copilot, MCP - 建议)或颗粒环境.
2.  **通用MCP一体化**: 不论CI提供者或代理选择,自动脚手架 `.cursor/mcp.json`, (中文(简体) ), `antigravity.mcp.json`,以及 `.vscode/mcp.json` 预配置 `@aisdlc/mcp`。 。 。 .
3.  **Canonical 启动模板**: 将38个模板部署到 `templates/` (产品、安全、隐私、安全、手册、合规性、SDD和CI/CD参考模板).
4.  **JSON Schemas(2020-12草案)**: 脚手架下所有34个计划 `schemas/` 如果磁盘文件被删除,则在校验时提供自动内存倒计时.
5.  **拖动请求模板**页:1 `.github/PULL_REQUEST_TEMPLATE.md` 不可谈判的计划执行矩阵`[X]` 对 `[O]`),"弱点"热点,以及自动化的KPI表格.
6.  **自动脚本注入**: 无损地登记消费者的标准快捷键 `package.json` (单位:千美元)`check`, (中文(简体) ), `check:fix`, (中文(简体) ), `verify:quality`, (中文(简体) ), `verify:privacy`, (中文(简体) ), `verify:all`, (中文(简体) ), `change:new`) (中文(简体) ).

### 2\. Spec-Driven开发与变革管理

| 命令 | 说明 | 密钥选项 |
| --- | --- | --- |
| `aisdlc change new <name>` | 脚手架 一个新的 SDD 更改软件包 (`proposal.md`, (中文(简体) ), `spec.md`, (中文(简体) ), `design.md`, (中文(简体) ), `tasks.md`有条条条 `handoff.yaml` 侧车. | `--from <ids...>`, (中文(简体) ), `--id <changeId>`, (中文(简体) ), `-p, --profile <patch|standard|critical>`, (中文(简体) ), `-f, --framework <openspec|speckit>`, (中文(简体) ), `-a, --author <author>`, (中文(简体) ), `--json` |
| `aisdlc sdd new <name>` | 别名 `aisdlc change new`。 。 。 . | 与 `change new` |
| `aisdlc sdd deposit` | 储存或再生峡谷 `handoff.yaml` (单位:千美元)`HOF-*`(a) 带有密码引用的侧车,用于积极改变. | `-c, --change <id>` _(必须)_, (中文(简体) ), `-f, --framework <framework>`, (中文(简体) ), `-t, --title <title>`, (中文(简体) ), `--requirements <reqs>`, (中文(简体) ), `--use-cases <ucs>`, (中文(简体) ), `--json` |
| `aisdlc sdd verify` | 验证 `handoff.yaml` 横跨活动变化的侧车. | `-f, --framework <framework>`, (中文(简体) ), `-r, --root <path>`, (中文(简体) ), `--json` |
| `aisdlc sdd integrate` | 推动完成的要求 `active`,更新架构组件链接,将提案标为 `applied`,并存档更改. | `--auto` _(检测从 git 上下文变化)_, (中文(简体) ), `-c, --change <id>`, (中文(简体) ), `-a, --author <author>`, (中文(简体) ), `--no-archive`, (中文(简体) ), `--json` |

### 3\. 核查和质量门`aisdlc verify`(中文(简体) )

| 命令 | 说明 | 密钥选项 |
| --- | --- | --- |
| `aisdlc verify [all]` | 执行综合的CI/CD套件,同时评价所有12个质量和治理大门. | `-r, --root <path>`, (中文(简体) ), `-p, --policy <path>`, (中文(简体) ), `-C <max-cc>`, (中文(简体) ), `-K <max-cog>`, (中文(简体) ), `-M <min-mi>`, (中文(简体) ), `-L <max-lines>`, (中文(简体) ), `-m <mode>`, (中文(简体) ), `--json` |
| `aisdlc verify quality` | 基于AST的放出闸门,评价循环复杂(10美元)、认知(15美元)、可维持性(50美元)和功能长度(40美元). | `-p, --policy <path>`, (中文(简体) ), `-C, --max-cyclomatic <n>`, (中文(简体) ), `-K, --max-cognitive <n>`, (中文(简体) ), `-M, --min-maintainability <n>`, (中文(简体) ), `-m <STRICT|PERMISSIVE>`, (中文(简体) ), `--json` |
| `aisdlc verify traceability` | 审计360°要求的可追踪性矩阵(生产 HOF $\\ left rightarrow$ 架构 CMP $\\ left rightarrow$ 测试) `.feature`) (中文(简体) ). | `-r, --root <path>`, (中文(简体) ), `--json` |
| `aisdlc verify governance` | 审计任务治理、人文审查计划和自主模式`AUTONOMOUS`, (中文(简体) ), `HUMAN_REVIEW_PLAN`(见a/c.5/49/70,附件). | `-r, --root <path>`, (中文(简体) ), `--json` |
| `aisdlc verify testing` | 对100%的要求和任务在磁盘上有相应的可核查测试的审计. | `-r, --root <path>`, (中文(简体) ), `--json` |
| `aisdlc verify gherkin` | 证明这一点 `.feature` 文件符合规格的 Gherkin 假想和相同的 SHA-256 文摘. | `-p, --path <path>`, (中文(简体) ), `-a, --all`, (中文(简体) ), `-r, --root <path>`, (中文(简体) ), `--json` |
| `aisdlc verify licenses` | 公开源码许可证的遵守和CVE针对 `license-policy.yaml` 带有动态SCA扫描,旋风DX 1.5 SBOM,以及法律通告. | `-p, --policy <path>`, (中文(简体) ), `--sbom [path]`, (中文(简体) ), `--notices [path]`, (中文(简体) ), `--tool <native|trivy|syft>`, (中文(简体) ), `--depth <direct|transitive>`, (中文(简体) ), `--vuln`, (中文(简体) ), `--vuln-max-critical <n>`, (中文(简体) ), `--vuln-max-high <n>`, (中文(简体) ), `--json` |
| `aisdlc verify pdac` | 将产品定义核实为密码图并对照SHA-256文摘进行密码漂移检查. | `-r, --root <path>`, (中文(简体) ), `--json` |
| `aisdlc verify schemas` | 验证规格 `handoff.yaml` 侧行车对阵舟山JSON Schemas (2020-12草案). | `-p, --path <path>`, (中文(简体) ), `-r, --root <path>`, (中文(简体) ), `--json` |
| `aisdlc verify duplicates` | 检测到冗余要求,ID相撞,标题词典冗余(=ge 85%美元),编码前BDD重叠. | `-s, --similarity <number>` _(违约:0.85)_, (中文(简体) ), `-r, --root <path>`, (中文(简体) ), `--json` |
| `aisdlc verify friction [change]` | 评估渐进摩擦和反潜行规则(核实修改范围与风险简介相符: `patch`, (中文(简体) ), `standard`, (中文(简体) ), `critical`) (中文(简体) ). | `-r, --root <path>`, (中文(简体) ), `--json` |
| `aisdlc verify security` | 统一转向左侧安全门:确定性秘密扫描(Gitleaks),SAST(OWASP Top 10),以及经审计的例外评论. | `-d, --diff`, (中文(简体) ), `-b, --base <branch>`, (中文(简体) ), `-g, --gitleaks`, (中文(简体) ), `-s, --semgrep`, (中文(简体) ), `-e, --entropy <n>`, (中文(简体) ), `-m, --min-severity <level>`, (中文(简体) ), `--audit-suppressions`, (中文(简体) ), `--suppressions-report <path>`, (中文(简体) ), `--json` |
| `aisdlc verify privacy` | 12号出入口:审计数据保护和逐一设计隐私`DATA-ASSET-*`, (中文(简体) ), `PRIV-ROPA-*`, (中文(简体) ), `PRIV-REQ-*`, (中文(简体) ), `DPIA-*`)和常设秘书处规则(`PRIV-001`– 说吧 –`PRIV-008`反对 `privacy-policy.yaml`。有关于违反行为的代码5的退出. | `-r, --root <path>`, (中文(简体) ), `-p, --policy <path>`, (中文(简体) ), `--no-reports`, (中文(简体) ), `--json` |
| `aisdlc verify secrets` | 扫描曝光的证书、 API 密钥、 信使和高通密( Shannon entropy $\\ge 4.3美元) 。 4号出口失败. | `-d, --diff`, (中文(简体) ), `-b, --base <branch>`, (中文(简体) ), `-g, --gitleaks`, (中文(简体) ), `-e, --entropy <n>`, (中文(简体) ), `--json` |
| `aisdlc verify sast` | 静态应用安全测试,用于SQL注射,指令注射,eval,SSF,路径traversal,并快速注射. | `-s, --semgrep`, (中文(简体) ), `-m, --min-severity <CRITICAL|HIGH|MEDIUM>`, (中文(简体) ), `--json` |

### 4\. Git 4-Tier分支管理`aisdlc git`(中文(简体) )

| 命令 | 说明 | 密钥选项 |
| --- | --- | --- |
| `aisdlc git checkout <task>` | 定位活动 SDD 更改中的任务并自动级联创建 4 级分支 : `main` 右转 `release/*` 右转 `feat/*` 右转 `task/*`。 。 。 . | `-r, --root <path>` |
| `aisdlc git plan` | 预览并规划一个给定的发布,特性和任务列表的视觉4级Git分支分层树. | `-r, --release <version>`, (中文(简体) ), `-f, --feature <feature>`, (中文(简体) ), `-t, --tasks <tasks>` |
| `aisdlc git validate <branch>` | 根据其等级(1至4)验证严格的分支命名惯例. | `<branch>` |
| `aisdlc git hook install` | 安装 `prepare-commit-msg` 自动挂载拖车注射的基特钩(`Task-ID`, (中文(简体) ), `Handoff-Digest`, (中文(简体) ), `Model`) (中文(简体) ). | `-r, --root <path>` |
| `aisdlc git detect-author` | 普遍和IDE独立检测当前承诺作者是人类还是AI代理. | `--json`, (中文(简体) ), `-r, --root <path>` |

### 5\. 报告和工程`aisdlc report` 打开 `aisdlc kpi`(中文(简体) )

| 命令 | 说明 | 密钥选项 |
| --- | --- | --- |
| `aisdlc report dashboard` | 生成100%的离线、自成一体的交互式网络仪表板和 Cytoscape.js PDAC/RTM 可视化器 `reports/dashboard.html`。 。 。 . | `-o, --output <path>`, (中文(简体) ), `-t, --title <title>`, (中文(简体) ), `--open` |
| `aisdlc report quality` | 用 Markdown 格式生成正式的多块码质量报告 `reports/QUALITY_REPORT.md`。 。 。 . | `-p, --policy <path>`, (中文(简体) ), `-m, --mode <STRICT|PERMISSIVE>`, (中文(简体) ), `-C, -K, -M, -L` 阈值 |
| `aisdlc kpi pr` | 计算用于PR模板的Pull Request远程测量总和表(人与代理作者比,审查时间,符号用法). | `-b, --base <branch>`, (中文(简体) ), `-h, --head <branch>`, (中文(简体) ), `-u, --update-file <path>`, (中文(简体) ), `--json` |
| `aisdlc kpi release` | 计算合并的释放量度:每个模型/人的排出率、缺陷密度和再造成本. | `--release <branch>` _(必须)_, (中文(简体) ), `-b, --base <branch>`, (中文(简体) ), `-o, --output <dir>`, (中文(简体) ), `--json` |

### 6\. BDD & Gherkin要求同步化(`aisdlc gherkin`(中文(简体) )

| 命令 | 说明 | 密钥选项 |
| --- | --- | --- |
| `aisdlc gherkin extract` | 摘录 `gherkin` 从Markdown规格的块并同步到 `.feature` 文件在 `tests/features/`。 。 。 . | `-p, --path <path>`, (中文(简体) ), `-a, --all`, (中文(简体) ), `--json`, (中文(简体) ), `-F, --format <format>` |

### 自动编码覆盖摄取量(.NET/Polyglot)

`aisdlc report quality` 财务报告和审定财务报表 `aisdlc report dashboard` 被动摄取标准地点的测试覆盖率:

-   `coverage/lcov.info` 或者说 `reports/lcov.info` (LCOV格式) (中文(简体) )
-   `coverage/coverage-summary.json` 或者说 `reports/coverage-summary.json` (伊斯坦布尔/JSON摘要格式)

#### 建立.NET/C#项目:

1.  保证 `coverlet.collector` 安装在您的测试项目中( y)`*.Tests.csproj`:
    
    ```xml
    <PackageReference Include="coverlet.collector" Version="6.*">
      <PrivateAssets>all</PrivateAssets>
      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
    </PackageReference>
    ```
    
2.  收集覆盖并将 Cobertura XML 转换为 LCOV 格式通过 **报告编辑器**数字 :
    
    ```bash
    # Run tests collecting coverage
    dotnet test --collect:"XPlat Code Coverage"
    
    # Convert to LCOV for AI-SDLC ingestion
    reportgenerator -reports:"**/coverage.cobertura.xml" -targetdir:"coverage" -reporttypes:lcov
    ```
    
3.  生成报告 :
    
    ```bash
    aisdlc report quality
    aisdlc report dashboard --open
    ```
    

### 共同工作流程实例

```bash
# 1. Initialize a new project with CI/CD and AI agent configurations
aisdlc init --ci github --agents all --arch minimal

# 2. Scaffold a new feature change citing an upstream use case
aisdlc change new "Real-Time Telemetry" --from UC-STREAM-TELEMETRY

# 3. Create and switch to the task branch in 4-tier hierarchy
aisdlc git checkout TSK-001

# 4. Run pre-flight check with auto-fix (syncs Gherkin and digests)
aisdlc check --fix

# 5. Run the consolidated CI/CD verification suite (all 12 gates)
aisdlc verify all

# 6. Generate the interactive web dashboard and open it in the browser
aisdlc report dashboard --open

# 7. Promote and integrate the change into the canonical baseline
aisdlc sdd integrate --auto
```

完整命令语法和任何命令的全部帮助:

```bash
aisdlc --help
aisdlc verify --help
aisdlc git --help
```

## 如何融为一体

CLI是主要开发商的出入口:

```text
                     Developer
                         │
                         ▼
                    aisdlc CLI
                         │
              ┌──────────┼──────────┐
              │          │          │
              ▼          ▼          ▼
            Check      Verify     Report
              │          │          │
              └──────────┼──────────┘
                         │
                         ▼
                    @aisdlc/core
                         │
                         ▼
                    AI-SDLC model
```

MCP为AI客户端提供了额外的集成路径:

```text
       AI client
           │
          MCP
           │
           ▼
     @aisdlc/mcp
           │
           ▼
     @aisdlc/core
```

## 为什么是AI-SDLC?

AI辅助开发改变软件如何生产.

AI-SDLC侧重于互补的问题:

**我们如何将AI引入软件工程而不失去对工程过程的控制?**

该框架通过明确的程序、质量控制、可追踪性和机器辅助核查来处理这一问题.

## 相关软件包

| 软件包 | 目的 |
| --- | --- |
| [`@aisdlc/cli`](https://www.npmjs.com/package/@aisdlc/cli) | 命令行接口 |
| [`@aisdlc/core`](https://www.npmjs.com/package/@aisdlc/core) | 核心能力 |
| [`@aisdlc/mcp`](https://www.npmjs.com/package/@aisdlc/mcp) | MCP一体化 |

## 项目结构

完整的AI-SDLC架构由GitHub寄存器维护.

**GitHub : (中文(简体) )** [https://github.com/altromon/AI-SDLC 页面存档备份,存于互联网档案馆](https://github.com/altromon/AI-SDLC)

该数据库载有完整的架构、治理模式、发展进程和文件.

## 捐款

欢迎发言、议题和建筑讨论.

请参看GitHub 捐款准则和发展信息库.

## 许可证

参见当前许可条款的存放许可证.

## 常见问题

### @aisdlc/cli 是什么？

AI-SDLC 质量门、治理和脚手架的指令行界面

### 如何安装 @aisdlc/cli？

在项目目录运行 npm install @aisdlc/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 aisdlc，可以用 npx aisdlc 直接运行。

### @aisdlc/cli 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @aisdlc/cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aisdlc/cli 可以商用吗？

@aisdlc/cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @aisdlc/cli 的下载量有多少？

根据 npm 官方下载统计，@aisdlc/cli 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,118 次，日均约 137 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aisdlc/cli 还在维护吗？

最新版本 3\.2\.0 发布于 2026/11/05（1 天前）；至今共发布 29 个版本，其中过去 12 个月发布了 29 个；首次发布于 2026/10/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。