@aisdlc/ 核心
核心图书馆 大赦国际-SDLC,一个AI本地软件开发生命周期框架,侧重于工程治理,可追溯性,质量门和受控AI辅助软件的提供.
什么是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 捐款准则和发展信息库.
许可证
参见当前许可条款的存放许可证.