weichen
b6ff0ab55f
Details (original message): Add catalog-driven orchestration: intent catalog injection, deterministic plan validation, and system-function steps.
31 lines
3.0 KiB
Markdown
31 lines
3.0 KiB
Markdown
# 项目工作入口
|
||
|
||
本项目采纳的通用规则：[核心规则](deps/development-guidelines/core/baseline.md)。
|
||
采纳范围、生效状态及项目差异：[采纳记录](policy/guidelines-adoption.md)。
|
||
项目事实、测试和环境入口：[PROJECT.md](PROJECT.md)。
|
||
|
||
- 启动：阅读以上短入口；只加载本次任务触发的专题。
|
||
- 普通交付：[交付流程](deps/development-guidelines/workflows/delivery.md)。
|
||
- 并行开发/正式测试/审核/合入：[共同基线与同步节点](deps/development-guidelines/standards/collaboration.md)，必须确认并实际同步最新权威目标。
|
||
- Bug/异常：[系统性排障](deps/development-guidelines/workflows/debugging.md)。
|
||
- 会话结束/换机器/换客户端/换执行者：[会话、执行者与机器交接](deps/development-guidelines/workflows/handoff.md)，状态写入任务主记录，不依赖本地会话历史。
|
||
- 测试与验收：[验证标准](deps/development-guidelines/standards/verification.md)。
|
||
- 模块/接口：[模块契约](deps/development-guidelines/standards/module-contracts.md)。
|
||
- 功能设计/跨模块变更：[设计与验证](deps/development-guidelines/workflows/design-verification.md)，按增量明确验收、独立测试及故障范围。
|
||
- 错误与过程事件：[可观测性](deps/development-guidelines/standards/observability.md)。
|
||
- 拆仓与 submodule：[多仓库与固定版本组合](deps/development-guidelines/standards/multi-repo.md)。
|
||
- 其他专题：按 [任务索引](deps/development-guidelines/README.md) 选择。
|
||
|
||
项目补充硬边界：
|
||
|
||
- 本库只做编排与任务拆解，不实现 Agent。智能体执行只来自 Agent-Native 或调用方注册的后端。
|
||
- 未知 backend fail-closed，禁止静默回落 stub。
|
||
- 意图闸门与能力目录为可选能力：唯 `squadintent` 与组合根（cli 接线）可 import agent-intent；`squad`/`server`/`store` 核心不感知意图（目录以 `squad.IntentCatalog` 数据视图注入）。未配置意图（无闸门或零意图）时引擎行为与原实现一致；闸门错误、守卫拒绝与系统功能步的目录/校验/handler 缺失均 fail-closed（`squad.intent_refused` / 明确步骤错误）。
|
||
- 磁盘上的运行状态是恢复权威；HTTP 错误使用稳定规范码和 `X-Trace-Id`，不以自由文本作为唯一错误合同。
|
||
- 依赖仓版本以本仓 gitlink 为准。构建时只认本仓 `go.mod` 的 `replace`；嵌套子模块里的 `replace` 不参与本仓编译。
|
||
|
||
任务权威：Gitea 仓库 `weichen/Agent-Squad` 的 Issue 与 Pull Request。
|
||
规范性文档目录与过程记录位置：`policy/` 放项目规则；`docs/records/` 为过程记录豁免目录。项目规范与过程记录不进通用规范库。
|
||
默认集成基线和提交身份：`main`；测试命令带 `GOWORK=off`。提交身份沿用本机 git 作者。
|
||
共享环境/发布入口及授权：无共享运行环境。权威远端 `ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Squad.git`。HTTP 开发入口默认 `:8090`，不含密钥。
|