# @aisdlc/core 中文文档

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

版本：3\.2\.0
npm 元数据更新时间：2026-11-04T18:25:29.759Z
中文译文更新时间：2026-11-06T06:10:10.147Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：6.3 MB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：6 个
- 首次发布：2026-10-02T09:51:53.820Z
- 最新版本发布：2026-11-04T18:25:29.380Z
- 近 30 天下载量：4579（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

AI-SDLC 的决定性域验证、遵守和报告引擎

## 安装

```sh
npm install @aisdlc/core
```

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

## README

# @aisdlc/ 核心

核心图书馆 **大赦国际-SDLC**,一个AI本地软件开发生命周期框架,侧重于工程治理,可追溯性,质量门和受控AI辅助软件的提供.

[![npm](https://img.shields.io/npm/v/@aisdlc/core)](https://www.npmjs.com/package/@aisdlc/core) [![npm downloads](https://img.shields.io/npm/dm/@aisdlc/core)](https://www.npmjs.com/package/@aisdlc/core)

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

AI-SDLC提供了一个结构化的方法,将AI纳入软件开发生命周期而不会失去工程学科,可追溯性或治理性.

该框架是围绕下列概念设计的:

-   软件开发生命周期治理
-   AI 辅助工程
-   可追踪性
-   质量门
-   软件要求和规格
-   改革管理
-   核查
-   工程计量和KPI
-   基于代理的工作流程
-   MCP一体化

`@aisdlc/core` 包含AI-SDLC生态系统使用的核心功能.

## 安装

```bash
npm install @aisdlc/core
```

或与平按:

```bash
pnpm add @aisdlc/core
```

或用纱线:

```bash
yarn add @aisdlc/core
```

## 使用量

核心包意在被作为AI-SDLC工具化,自动化,自定义集成的基础.

```typescript
import {
  verifyQualityGate,
  verifyTraceability,
  verifySecrets,
  scaffoldSddChange,
  generateDashboardReport,
  readCodeCoverageSummary,
} from '@aisdlc/core';

// 1. Run the deterministic Quality Gate on the codebase
const qualityResult = verifyQualityGate({
  rootDir: process.cwd(),
});
console.log(`Quality gate passed: ${qualityResult.success}`);

// 2. Audit 360° Requirements Traceability Matrix
const traceResult = verifyTraceability({
  rootDir: process.cwd(),
});
console.log(`Missing test coverage count: ${traceResult.missingTests}`);

// 3. Scan for exposed credentials and high-entropy secrets
const secretResult = verifySecrets({
  rootDir: process.cwd(),
});
console.log(`Secret violations found: ${secretResult.violations.length}`);

// 4. Ingest automated test coverage (LCOV from Coverlet/ReportGenerator, Vitest, etc.)
const coverage = readCodeCoverageSummary(process.cwd());
if (coverage) {
  console.log(`Line coverage: ${coverage.linesPct}%, Branch: ${coverage.branchesPct}%`);
}
```

## AI-SDLC 架构

该项目将核心工程能力与其接口和集成分开:

```text
                    AI-SDLC
                       │
             ┌─────────┴─────────┐
             │                   │
        @aisdlc/core       Integration layer
             │             ┌─────┴─────┐
             │             │           │
             │        @aisdlc/mcp  @aisdlc/cli
             │
             └──── Core engineering capabilities
```

这种分离使得核心功能能够被不同的接口和集成再利用.

## 核心能力

`@aisdlc/core` 提供7个职能类别的综合领域逻辑、核查引擎和治理设施:

### 1\. Spec-Driven开发(SDD)和PDAC架构

| 能力 | 说明 | 初级出口 |
| :-- | :-- | --- |
| **改变脚手架** | 决定性的脚手架活动 SDD 更改套件(`proposal.md`, (中文(简体) ), `spec.md`, (中文(简体) ), `design.md`, (中文(简体) ), `tasks.md`) 有相通的编号和条纹 `handoff.yaml` 侧车. | `scaffoldSddChange`, (中文(简体) ), `getNextCorrelativeNumber`, (中文(简体) ), `slugify` |
| **产品手提车** | 产生、储存和验证 `handoff.yaml` (单位:千美元)`HOF-*`带有密码的副车SHA-256在变化中引用. | `depositProductHandoffSidecar`, (中文(简体) ), `loadProductHandoffSidecar`, (中文(简体) ), `scanAllProductHandoffs` |
| **改变一体化和促进** | 将核准的要求推广到活动基线,将结构组成部分链接起来,应用建议,以及档案更改工作空间. | `integrateSddChange`, (中文(简体) ), `verifySddIntegration`, (中文(简体) ), `detectActiveChangeForIntegration` |
| **SDD 框架适应器** | 多态抽象层支持多种SDD规格格式(OpenSpec和SpecKit)无缝. | `getSddAdapter`, (中文(简体) ), `OpenSpecAdapter`, (中文(简体) ), `SpecKitAdapter` |
| **PDAC 图形和密码漂移** | 将产品定义构建为代码图并审计SHA-256不同规格的文摘,以检测出同步漂移. | `verifyPdacGraph`, (中文(简体) ), `syncPdacDigests`, (中文(简体) ), `computeCanonicalSha256`, (中文(简体) ), `extractCitations` |
| **进取滑动和反跳动** | 根据变化风险简介实施治理闸门`patch`, (中文(简体) ), `standard`, (中文(简体) ), `critical`),并阻止未经授权地修改被保护的核心路径. | `verifyProgressiveFriction`, (中文(简体) ), `detectProfileFromChange`, (中文(简体) ), `isPathProtectedFromPatch` |

### 2\. 质量门和AST编码计量

| 能力 | 说明 | 初级出口 |
| :-- | :-- | --- |
| **决定性质量门** | 根据正式政策评估编码基础`quality-policy.yaml`) 跨 Cyclomatic 复杂度,认知复杂度,可维持性指数和函数长度. | `verifyQualityGate`, (中文(简体) ), `createDefaultQualityPolicy`, (中文(简体) ), `parseQualityPolicy` |
| **Polyglot 和 TypeScript AST 分析** | 基于原生的 AST 函数和类分量提取用于 TypeScript/JavaScript, 外加 Python, Go, Java, C#, C++,和 Rust 的零热解析. | `extractFunctions`, (中文(简体) ), `extractFunctionsTypeScriptAst`, (中文(简体) ), `extractFunctionsPolyglot`, (中文(简体) ), `calculateMetrics` |

### 3\. 核查和合规引擎

| 能力 | 说明 | 初级出口 |
| :-- | :-- | --- |
| **360° 要求可追踪性矩阵** | 对上游产品交易之间的双向可追踪联系的审计`HOF`),中流Arc42组件(`CMP`)和下游接受试验`.feature`) (中文(简体) ). | `verifyTraceability`, (中文(简体) ), `generateTraceabilityReportMarkdown`, (中文(简体) ), `parseFrontmatter` |
| **任务治理和人文审查计划** | 审计任务完成情况、人员审查清单和自主分类级别(`AUTONOMOUS`, (中文(简体) ), `HUMAN_REVIEW_PLAN`(见a/c.5/49/70,附件). | `verifyTasksGovernance`, (中文(简体) ), `generateGovernanceReportMarkdown`, (中文(简体) ), `parseTasksDoc` |
| **核查和接受试验范围** | 验证100%的已定义要求和工程任务在磁盘上进行了相应的自动化测试. | `verifyTestingCoverage`, (中文(简体) ), `scanAllTestArtifacts`, (中文(简体) ), `generateTestingCoverageReportMarkdown` |
| **规格Schema 验证** | 对照Cononical JSON Schemas(2020-12草案)验证Markdown前事和结构,用于建议书,规格,设计和任务. | `verifyArtifactsSchemas`, (中文(简体) ), `validateArtifactSchema`, (中文(简体) ), `validateAgainstSchema` |
| **复制要求** | 计算和计算词汇相似性(Jacccard $\\ge 85%美元),重复的散列,以及代码作者之前的 BDD 情景相撞. | `verifyArtifactDuplicates`, (中文(简体) ), `calculateJaccardSimilarity`, (中文(简体) ), `generateDuplicatesReportMarkdown` |
| **BDD 格金同步** | 摘录 `gherkin` 块与 Markdown 规格并同步到独立的可执行文件 `.feature` 文件在 `tests/features/`。 。 。 . | `extractGherkinFeatures`, (中文(简体) ), `checkGherkinInSync`, (中文(简体) ), `extractGherkinBlock` |

### 4\. 安全和软件供应链(SCA/SAST)

| 能力 | 说明 | 初级出口 |
| :-- | :-- | --- |
| **许可遵守和SCA** | 扫描直接依赖和中转依赖,将 SPDX 标识符与 `license-policy.yaml`标记限制/封禁许可证,并评估脆弱性阈值. | `verifyLicenses`, (中文(简体) ), `scanInstalledLicenses`, (中文(简体) ), `scanWithNativeFs`, (中文(简体) ), `scanWithTrivy`, (中文(简体) ), `scanWithSyft`, (中文(简体) ), `evaluateVulnerabilityThresholds` |
| **SBOM和第三方通知** | 生成企业准备的CirbonDX 1.5 JSON SBOMS并编译完整的打分第三方许可通知. | `generateCycloneDxSbom`, (中文(简体) ), `writeCycloneDxSbom`, (中文(简体) ), `generateThirdPartyNotices`, (中文(简体) ), `writeThirdPartyNotices` |
| **秘密扫描和 Entropy 审计** | 扫描已曝光的 API 密钥的 git diffs 和 codebase 文件, 私人证书, 以及高通字符串 (Shannon entropy $\\ge 4. 3$) 。 审计结构化例外压制. | `verifySecrets`, (中文(简体) ), `calculateShannonEntropy`, (中文(简体) ), `runGitleaksCli`, (中文(简体) ), `generateSecretsReportMarkdown`, (中文(简体) ), `parseSecuritySuppression`, (中文(简体) ), `generateSuppressionsAuditReport` |
| **静态应用安全** | OWASP Top 10 脆弱性(SQLi、指令注射、SSF、路径转录、即时注射)的AST和模式分析。 支持"Semgrep CLI". | `verifySast`, (中文(简体) ), `scanFileForSast`, (中文(简体) ), `runSemgrepCli`, (中文(简体) ), `detectPromptInjection` |
| **数据保护与隐私逐一设计(PII-SAST & RoPA)** | 个人数据资产`DATA-ASSET-*`), GDPR 第30条 记录`PRIV-ROPA-*`),隐私要求`PRIV-REQ-*`),DPIA出入口(`DPIA-*`)和静态的PII-SAST规则(`PRIV-001`– 说吧 –`PRIV-008`反对 `privacy-policy.yaml`。 。 。 . | `verifyPrivacy`, (中文(简体) ), `loadPrivacyPolicy`, (中文(简体) ), `scanFileForPrivacyViolations`, (中文(简体) ), `generateRopaInventoryMarkdown`, (中文(简体) ), `generatePrivacyReportMarkdown` |

### 5\. Git 4-Tier 工作流程、提交拖车和代理检测

| 能力 | 说明 | 初级出口 |
| :-- | :-- | --- |
| **4-Tier Git分部管理** | 分类和主持4级分支层级(`main` 右转 `release/*` 右转 `feat/*` 右转 `task/*`确保隔离和纪律. | `classifyBranch`, (中文(简体) ), `generateBranchHierarchyPlan` |
| **自动任务检查** | 从活动 SDD 更改中解析任务上下文,并自动取出或级联需要分行级. | `checkoutTaskBranch`, (中文(简体) ), `locateTaskInActiveChanges`, (中文(简体) ), `resolveBranchHierarchy` |
| **提交拖车引擎** | 参数、格式和验证标准化的 Git 承付拖车(`Task-ID`, (中文(简体) ), `Handoff-Digest`, (中文(简体) ), `Model`, (中文(简体) ), `Autonomy`) (中文(简体) ). | `parseCommitTrailers`, (中文(简体) ), `formatCommitTrailers`, (中文(简体) ), `inferMissingTrailers`, (中文(简体) ), `extractCommitKpisFromRange` |
| **AI 代理作者检测** | 普遍和IDE-独立地检测出git是否承诺或活动会话来自人类开发者或AI代理. | `detectAuthorIdentity` |
| **Git Hook 安装器** | 程序上安装了决定性的Git钩(例如. `prepare-commit-msg`)用于自动元数据注入. | `installGitHooks` |

### 6\. 报告、工程、KPIs和互动板

| 能力 | 说明 | 初级出口 |
| :-- | :-- | --- |
| **交互式离线盘** | 用 Cytoscape.js 交互式图表生成一个100%自成一体的下行 HTML 仪表板,用于可视化完整的 PDAC 和 RTM 网络(包括 `ARCH-INTRO-*`边框 `BC-*`, (中文(简体) ), `DATA-ASSET-*`, (中文(简体) ), `PRIV-ROPA-*`,以及 `PRIV-REQ-*`) (中文(简体) ). | `generateDashboardReport`, (中文(简体) ), `buildGraphElements`, (中文(简体) ), `renderDashboardHtml` |
| **正式守则质量报告** | 将颗粒多块块编码质量分析汇编成结构化的Markdown报告(`reports/QUALITY_REPORT.md`) (中文(简体) ). | `generateQualityReport`, (中文(简体) ), `writeQualityReport`, (中文(简体) ), `calculateRating` |
| **代码覆盖摄取量** | 被动摄取标准格式的测试覆盖摘要(`coverage/lcov.info`, (中文(简体) ), `coverage/coverage-summary.json`)跨多块堆栈(.NET通过Coverlet & ReportGenerator,Node.js,Python). | `readCodeCoverageSummary` |
| **拖动请求 KPIs 遥测( T)** | 计算人对AI代理贡献比率,审查周期持续时间,以及象征性使用,将其格式化为PR模板. | `aggregatePrKpis`, (中文(简体) ), `formatPrKpiMarkdown`, (中文(简体) ), `injectKpisIntoPrBody` |
| **释放 KPIs 和 Defect 注射率** | 计算释放级工程计量标准,每个作者/模型的缺陷注射率(DIR),再造成本和缺陷密度. | `aggregateReleaseKpis`, (中文(简体) ), `formatReleaseKpiMarkdown`, (中文(简体) ), `writeReleaseKpiReport` |

### 7\. 仓库脚手架和治理

| 能力 | 说明 | 初级出口 |
| :-- | :-- | --- |
| **AI-SDLC 工程启动** | 配置政策( E)`quality-policy.yaml`, (中文(简体) ), `license-policy.yaml`, (中文(简体) ), `privacy-policy.yaml`),所有34个计划,38个启动模板,arc42架构模板,CI工作流程,以及AI代理规则(11个专业代理). 向消费者注入标准 npm 脚本 `package.json`。 。 。 . | `initProject`, (中文(简体) ), `resolveAgentTargets`, (中文(简体) ), `collectAgentFiles` |
| **Canonical 启动模板 & Schemas** | 所有34个2020-12 JSON计划草案和38个基准模板(生产、安全、隐私、安全、手册、遵守、SDD、CI/CD)的预先捆绑、打入常数。 在计划验证中提供自动内反演. | `STARTER_BASE_TEMPLATES`, (中文(简体) ), `STARTER_SCHEMAS`, (中文(简体) ), `STARTER_SCHEMAS_MAP`, (中文(简体) ), `STARTER_QUALITY_POLICY`, (中文(简体) ), `STARTER_LICENSE_POLICY`, (中文(简体) ), `STARTER_PRIVACY_POLICY`, (中文(简体) ), `STARTER_PULL_REQUEST_TEMPLATE`, (中文(简体) ), `STARTER_GITHUB_PULL_REQUEST_TEMPLATE` |
| **通用MCP脚手架** | 预先捆绑的模型上下文协议服务器配置文件,用于即时IDE集成,而无需手动设置. | `STARTER_CURSOR_MCP`, (中文(简体) ), `STARTER_ANTIGRAVITY_MCP`, (中文(简体) ), `STARTER_VSCODE_MCP` |
| **多供应商CI/CD管道** | 使用 `npx @aisdlc/cli` gitHub Actions(包括自动化的PR KPI聚合),GitLab CI,Azure DevOps,和Bitbucket管道. | `STARTER_GITHUB_CI`, (中文(简体) ), `STARTER_GITHUB_SDD_INTEGRATE`, (中文(简体) ), `STARTER_GITHUB_PR_KPI`, (中文(简体) ), `STARTER_GITHUB_DEPLOY_DASHBOARD`, (中文(简体) ), `STARTER_GITLAB_CI`, (中文(简体) ), `STARTER_AZURE_PIPELINES`, (中文(简体) ), `STARTER_BITBUCKET_PIPELINES` |

## 我什么时候用这个包裹?

使用 @aisdlc/ core 当您是 :

-   在 AI-SDLC 上架工具
-   将AI-SDLC纳入现有工程平台
-   创建自定义 AI 辅助开发工作流程
-   发展扩展或一体化
-   以 AI- SDLC 能力建立自己的接口

如果您只是想要使用命令行的 AI- SDLC, 请从 [@aisdlc/ cli (英语)](https://www.npmjs.com/package/@aisdlc/cli)。 。 。 .

如果你想加入MCP,请看 [@aisdlc/ mcp (英语)](https://www.npmjs.com/package/@aisdlc/mcp)。 。 。 .

## 相关软件包

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

## 项目

AI-SDLC是一个开源项目:

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

关于结构、治理、流程和完整的项目文件,见存储库.

## 捐款

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

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

## 许可证

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

## 常见问题

### @aisdlc/core 是什么？

AI-SDLC 的决定性域验证、遵守和报告引擎

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

在项目目录运行 npm install @aisdlc/core，或使用 pnpm add / yarn add / bun add。

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

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

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

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

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

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

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

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

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

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