这个项目能做什么

# Agent Teams 工程基础 本仓库为 Agent Teams 仓库提供版本化的工程策略、工具与一致性基础。它仅包含可复用的开发工具；产品运行时代码不得导入它。每个使用方对其自身的领域模型、包目录、依赖权限、安全分类和 ADR 保持权威性。 ## 范围 - 严格的数据仅限使用方配置和版本化模式 - 可执行的工作区声明和源依赖策略 - 受治理的内联抑制和已发布的公共 API 兼容性 - 可执行的规范说明与使用方门禁连接 - 仓库工作流、SBOM、来源和包内容安全策略 - 可移植的代理指令和变更文件预检路由 - 可选确定性组合现有包脚本质量门禁 - 共享的 Oxlint 和 TypeScript 7 基线预设 - 显式注册表和本地链接模式 - 确定性附加、状态、分离和注册表断言 - 封闭确定性“意图 -> 计划 -> 应用 -> 收据”脚手架 - 受治理的文档目录、确定性非保留规划、仅创建发布和精确版本恢复命令 - 隔离的包内容和使用方验证 - 不可变公共 npm 版本的发布自动化 能力从已验证的仓库中增量提取。只有具备对等夹具和使用方一致性测试时，能力才会移至此。`workspace.dependency-declarations` 和 `architecture.source-dependencies` 处于活动状态并已自用。仓库使用带显式 `packages` 包根的 schema v2，而已发布的 v1 契约仍可为现有使用方加载。 ## 命令 ```bash pnpm install pnpm check:changed pnpm check:fast pnpm check pnpm verify pnpm package:check pnpm quality:gate:fast pnpm foundation:qualification ``` 使用方使用： ```bash pnpm foundation:check pnpm foundation:attach -- /absolute/path/to/engineering-foundation pnpm foundation:status pnpm foundation:detach pnpm foundation:assert-dev-only pnpm foundation:assert-registry ``` 任何仓库无需变更即可预览可移植文档设置： ```bash docs-protocol init --project-id example/widgets \ --owner documentation/team --dry-run --json ``` 应用审查后的摘要后，`docs.config.yaml` 会自动发现。搜索和有界上下文保持可丢弃投影： ```bash docs-protocol find "tenant isolation" --fuzzy docs-protocol context "tenant isolation" --fuzzy --max-documents 12 docs-protocol check ``` 受治理的文档编写使用已安装的 Docs Protocol CLI。`owner` 和 `summary` 是显式意图权威，绝不接收基础默认值： ```bash agent-teams-docs find "tenant isolation" agent-teams-docs new --type adr --id ADR-0083 \ --title "Tenant isolation" --owner architecture/tooling \ --summary "Defines the tenant-isolation boundary and its verification evidence." \ --dry-run agent-teams-docs doctor agent-teams-docs recover agent-teams-docs-managed upgrade --to docs-YYYY-MM-DD-N --target-generation 2 --json ``` 审查干运行后，使用 `--apply` 重复 `agent-teams-docs new`，遵循其精确可达性指令，并运行使用方的标准仓库检查。 `foundation:check` 发出一个确定性汇总报告，并强制执行每个声明能力。可选的 `repository.agent-workflow` 能力保持 `AGENTS.md` 在编码代理间规范，并通过共享基础实现路由 `check:changed`；所需 CI 仍运行完整 `verify` 证据作为独立失败关闭通道。 `foundation:assert-dev-only` 拒绝运行时依赖放置。`foundation:assert-registry` 额外证明声明的精确版本具有匹配的 pnpm 锁文件导入器、npm 包条目、sha512 完整性以及无链接、源 URL、覆盖或补丁的快照。 脚手架内核暴露严格模式和日志文件系统适配器。它包含仅测试的一致性夹具和一个通用私有 Node TypeScript 库边界配方。后者仅创建包信封；使用方业务包、角色、所有者文档和功能切片仍归使用方所有。 参见 [所有权](docs/architecture/ownership.md)、[一致性证据门禁](docs/architecture/consistency-evidence-gate.md)、[治理能力验收审查](docs/research/governance-capability-acceptance-review.md)、[本地开发](docs/development/local-mode.md) 和 [发布程序](docs/release.md)。完整文档索引见 [docs/README.md](docs/README.md)。