Agent-Native/PROJECT.md

Agent-Native 项目事实

工作规则见 AGENTS.md。此文件维护本项目事实，不复制通用规范。

仓库与操作

• 目标/产品边界：独立的 Agent 执行基础库。提供执行契约（contract）、执行端口（exec）、自研运行时（runtime）、外部适配器（adapters）与行为验收（conformance）。不实现小队编排，不依赖 Core 或 Squad。
• 源码、资产、文档、机器契约位置：Go 源码在仓库根包目录；模块路径 agent-native；人类文档在根 README.md、docs/、policy/；过程记录在 docs/records/；机器契约以 contract 包类型为准。
• 权威远端、集成基线、受保护分支：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Native.git，集成基线 main。
• 并行共同基线记录位置、合入通知/主动检查方式：任务主记录在 Gitea Issue/PR；合入前在本仓 main 上 git fetch 并确认 HEAD。
• 发布线与批准版本/实际制品查询入口：当前无独立制品仓库。可构建性以本仓 main 的 go test 为准；依赖子模块版本以 gitlink 为准，不把工作区未提交文件当发布组合。
• 提交/审核/合并/发布身份与权限：仓库所有者 weichen。本机提交不代替远端合并。
• 任务唯一来源：Gitea weichen/Agent-Native 的 Issue 与 Pull Request。
• 规范性文档目录：policy/。
• 过程文档仓/目录：docs/records/（项目内豁免，理由见 采纳记录）。
• 交接记录位置：随任务主记录；需要落盘的交接放入 docs/records/。
• 凭证查找入口及所需字段：模型与 Runner 凭证由调用方注入，不入库。本仓不保存密钥字段的值。

依赖组合

逻辑 ID	路径	角色
development-guidelines	deps/development-guidelines	development-only，规范文本
error-code-system	deps/error-code-system	build-required，规范码目录
logging-system	deps/logging-system	build-required，可选日志器
agent-intent	deps/agent-intent	build-required，可选意图闸门装饰器（adapters/intentgate）

克隆：

git clone --recurse-submodules ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Native.git
# 已克隆时：git submodule update --init --recursive

构建、审核和发布固定父仓 gitlink，不执行 submodule update --remote。

验证命令

影响	工作目录与真实命令/CI	前提与不覆盖范围
文档	人工核对 AGENTS.md、PROJECT.md、policy/ 相对链接	不证明运行时行为
模块/接口	仓库根：go vet ./... && go test -count=1 ./...	需要 Go 1.27；不覆盖真实模型端点
数据/权限/恢复	不适用独立数据库。契约测试覆盖副作用分类与取消传播	不证明调用方产品库的持久化
UI/执行后端	go test ./adapters/... ./runtime/... ./conformance/...	默认 fake/stub；真实模型需调用方提供端点，本命令不覆盖
治理与 Agent 执行配置	仓库根（需在暂存副本中先 git add -A，gitlink 须在索引中）：scripts/dm governance check --repo . 与 scripts/agent-exec validate --repo .	只核验采纳文件、固定组合与 AGENT-EXECUTION.md 配置，不证明执行结果

环境与数据

环境/实例 ID	只读查询入口	授权写入入口	DB/存储归属	恢复入口
本地开发	本机工作区与 go test	本机 git 提交	无共享数据库；会话文件由调用方 Workspace 决定	重新 clone 父仓并 submodule update --init --recursive

共享项及 ACL：无。部署、迁移、发布的审批依据与负责角色：当前库不独立部署；合并进 main 由仓库所有者批准。 实际制品/配置/schema 的查询方法：阅读当前 main 的 contract 包与 go.mod，不以历史 README 快照代替。