@aisdlc/core

中文文档
3.2.0发布于 2026/11/05MITTypeScriptESM + CJS构建来源已验证近 30 天下载 4579

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

中文使用文档
文档目录18 节
  1. 什么是AI-SDLC? (英语)?
  2. 安装
  3. 使用量
  4. AI-SDLC 架构
  5. 核心能力
  6. 1. Spec-Driven开发(SDD)和PDAC架构
  7. 2. 质量门和AST编码计量
  8. 3. 核查和合规引擎
  9. 4. 安全和软件供应链(SCA/SAST)
  10. 5. Git 4-Tier 工作流程、提交拖车和代理检测
  11. 6. 报告、工程、KPIs和互动板
  12. 7. 仓库脚手架和治理
  13. 我什么时候用这个包裹?
  14. 相关软件包
  15. 项目
  16. GitHub : (中文(简体) ) https://github.com/altromon/AI-SDLC 页面存档…
  17. 捐款
  18. 许可证

@aisdlc/ 核心

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

npm npm downloads

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

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

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

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

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

安装

npm install @aisdlc/core

或与平按:

pnpm add @aisdlc/core

或用纱线:

yarn add @aisdlc/core

使用量

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

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 架构

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

                    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 (英语)。 。 。 .

如果你想加入MCP,请看 @aisdlc/ mcp (英语)。 。 。 .

软件包目的
@aisdlc/ 核心AI-SDLC核心能力
@aisdlc/ cli (英语)命令行接口
@aisdlc/ mcp (英语)MCP一体化

项目

AI-SDLC是一个开源项目:

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

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

捐款

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

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

许可证

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

版本与发布记录

@aisdlc/core 共发布 30 个版本,首次发布于 2026/10/02;过去 12 个月发布了 30 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.2.0latest2026/11/051 天前
3.1.02026/11/042 天前
3.0.02026/11/024 天前
2.5.12026/11/015 天前
2.5.02026/10/316 天前
2.4.02026/10/306 天前

关于 @aisdlc/core 的常见问题

@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 和提交记录判断。