@gon1942/ai-dev-external-framework

中文文档
1.3.3发布于 2026/11/04MIT零依赖近 30 天下载 3806

npx bootstrap for the Team AI Dev Framework Python workflow engine

原始使用文档

Team AI Dev Framework — npm/npx bootstrap

Node.js 20+, Python 3.10+ 필요. Python 엔진 WHL을 npm 패키지에 동봉해 pip install 수동 작업 없이 프로젝트 전용 .ai-dev/.runtime/에 설치합니다. Python 본체는 별도 설치가 필요합니다. npm Registry 게시 전에는 원격 npx 대신 로컬 패키지로 시험하세요.

# 신규 프로젝트
npx --yes @gon1942/[email protected] init my-project

# 기존 Team AI Dev 프로젝트 업그레이드 — 기본 미리보기
npx --yes @gon1942/[email protected] upgrade --project .
npx --yes @gon1942/[email protected] upgrade --project . --apply

# 기존 다른 프레임워크 없는 프로젝트에 비파괴 설치
npx --yes @gon1942/[email protected] adopt --project . --apply

# 실행 및 검사
npx --yes @gon1942/[email protected] doctor --project .
npx --yes @gon1942/[email protected] cli --project . -- startup

주의

  • 신규 패키지명 @gon1942/teamdev-framework는 게시 전 Registry 사용 가능 여부와 계정 권한을 확인해야 합니다. 게시 전에는 로컬 npm tarball로 시험하세요.
  • 기존 ai-dev-external-framework의 scripts/workflow.py, .ai-dev/stage-skills.json 등이 있으면 자동 교체하지 않고 중단합니다. 두 프레임워크는 상태 스키마가 달라 단순 upgrade로 이전할 수 없습니다.
  • upgrade는 기본적으로 미리보기만 제공하며 실제 파일 변경에는 --apply가 필요합니다.
  • 모델 설치·API 인증·Python 설치·Git 상태 공유는 자동화하지 않습니다.
  • teamdev를 PATH 전역 명령으로 설치하지 않습니다. npm CLI의 cli --project . -- <command>를 사용하세요.
  • .ai-dev/.runtime/은 로컬 전용이며 Git에 포함하지 않습니다.
  • --apply 시 각 업그레이드의 독립적인 안전 검사가 동작하며, 여러 명령을 묶은 전체 롤백은 아직 지원하지 않습니다. 실행 전 Git 상태와 백업을 확인하세요.

Worker 보고서 JSON 사전검사 (v0.19.1)

team-ai-dev cli --project . -- report-template TASK-ID --output docs/tasks/TASK-ID/implementer-input.json로 입력용 JSON 템플릿을 만들고, 실제 증거를 입력한 후 report-check를 수행하세요. report.md는 CLI 입력이 아닙니다. 기존 Team AI Dev 프로젝트에는 upgrade --project . --apply 실행 시 upgrade-report-contract가 적용됩니다. 기존 다른 개발 프레임워크의 상태 자동 이관은 지원하지 않습니다.

版本与发布记录

@gon1942/ai-dev-external-framework 共发布 19 个版本,首次发布于 2026/10/26;过去 12 个月发布了 19 个版本。

版本发布日期距今
1.3.3latest2026/11/0412 天前
1.3.22026/10/3017 天前
1.3.12026/10/3017 天前
1.3.02026/10/2918 天前
1.2.02026/10/2918 天前
1.1.02026/10/2918 天前

关于 @gon1942/ai-dev-external-framework 的常见问题

@gon1942/ai-dev-external-framework 是什么?

npx bootstrap for the Team AI Dev Framework Python workflow engine

如何安装 @gon1942/ai-dev-external-framework?

在项目目录运行 npm install @gon1942/ai-dev-external-framework,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 team-ai-dev,可以用 npx team-ai-dev 直接运行。

@gon1942/ai-dev-external-framework 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/gon1942__ai-dev-external-framework 是否存在。

@gon1942/ai-dev-external-framework 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@gon1942/ai-dev-external-framework 可以商用吗?

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

@gon1942/ai-dev-external-framework 的下载量有多少?

根据 npm 官方下载统计,@gon1942/ai-dev-external-framework 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,806 次,日均约 127 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gon1942/ai-dev-external-framework 还在维护吗?

最新版本 1.3.3 发布于 2026/11/04(12 天前);至今共发布 19 个版本,其中过去 12 个月发布了 19 个;首次发布于 2026/10/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。