@aisdlc/ cli (英语)
命令行接口 大赦国际-SDLC,用于受管,可追踪,质量驱动的AI辅助软件工程的AI-原生软件开发生命周期框架.
什么是AI-SDLC? (英语)?
AI-SDLC是将AI纳入软件开发生命周期同时维持工程纪律的框架.
它将AI协助发展与下列做法结合起来:
- 要求和规格
- 改革管理
- 核查
- 质量门
- 可追踪性
- 工程 KPIs
- 基于 Git 的工作流程
- 代理工程
- MCP一体化
CLI为这些能力提供主指令行入站.
安装
全球安装
npm install -g @aisdlc/cli
然后说:
aisdlc --help
当地安装
npm install @aisdlc/cli
或者说:
pnpm add @aisdlc/cli
快开始
安装后运行 :
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提供统包治理环境:
- 交互式引导提示( TTY 模式)数字 :
- CI/CD 供应商: GitHub 动作 (默认/ 建议), GitLab CI, Azure DevOps 管道, Bitbucket 管道, 或者无.
- 建筑外观: 最小/基线( 默认值 :
ARCH-INTRO-*, (中文(简体) ),CMP-*, (中文(简体) ),ADR-*),全(全部为12个弧度42节),或无. - AI 代理人: All (Cursor, Claude Code, Antigravity, Copilot, MCP - 建议)或颗粒环境.
- 通用MCP一体化: 不论CI提供者或代理选择,自动脚手架
.cursor/mcp.json, (中文(简体) ),antigravity.mcp.json,以及.vscode/mcp.json预配置@aisdlc/mcp。 。 。 . - Canonical 启动模板: 将38个模板部署到
templates/(产品、安全、隐私、安全、手册、合规性、SDD和CI/CD参考模板). - JSON Schemas(2020-12草案): 脚手架下所有34个计划
schemas/如果磁盘文件被删除,则在校验时提供自动内存倒计时. - 拖动请求模板页:1
.github/PULL_REQUEST_TEMPLATE.md不可谈判的计划执行矩阵[X]对[O]),"弱点"热点,以及自动化的KPI表格. - 自动脚本注入: 无损地登记消费者的标准快捷键
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#项目:
- 保证
coverlet.collector安装在您的测试项目中( y)*.Tests.csproj:<PackageReference Include="coverlet.collector" Version="6.*"> <PrivateAssets>all</PrivateAssets> <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets> </PackageReference> - 收集覆盖并将 Cobertura XML 转换为 LCOV 格式通过 报告编辑器数字 :
# 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 - 生成报告 :
aisdlc report quality aisdlc report dashboard --open
共同工作流程实例
# 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
完整命令语法和任何命令的全部帮助:
aisdlc --help
aisdlc verify --help
aisdlc git --help
如何融为一体
CLI是主要开发商的出入口:
Developer
│
▼
aisdlc CLI
│
┌──────────┼──────────┐
│ │ │
▼ ▼ ▼
Check Verify Report
│ │ │
└──────────┼──────────┘
│
▼
@aisdlc/core
│
▼
AI-SDLC model
MCP为AI客户端提供了额外的集成路径:
AI client
│
MCP
│
▼
@aisdlc/mcp
│
▼
@aisdlc/core
为什么是AI-SDLC?
AI辅助开发改变软件如何生产.
AI-SDLC侧重于互补的问题:
我们如何将AI引入软件工程而不失去对工程过程的控制?
该框架通过明确的程序、质量控制、可追踪性和机器辅助核查来处理这一问题.
相关软件包
| 软件包 | 目的 |
|---|---|
@aisdlc/cli | 命令行接口 |
@aisdlc/core | 核心能力 |
@aisdlc/mcp | MCP一体化 |
项目结构
完整的AI-SDLC架构由GitHub寄存器维护.
GitHub : (中文(简体) ) https://github.com/altromon/AI-SDLC 页面存档备份,存于互联网档案馆
该数据库载有完整的架构、治理模式、发展进程和文件.
捐款
欢迎发言、议题和建筑讨论.
请参看GitHub 捐款准则和发展信息库.
许可证
参见当前许可条款的存放许可证.