Files
Agent-System-Dev/policy/guidelines-adoption.md
T

32 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 通用规范采纳记录
- 项目/负责人:Agent-System-Dev / weichen
- 状态:active
- 规范位置:`deps/development-guidelines`
- 规范性文档目录:`policy/`(项目规则与制度放此处;只收紧不放宽上游规范)
- 过程文档位置:任务卡 `.task/`,归档 `.task/archive/`,规划记录 `docs/superpowers/plans/`;任务主记录在对应 PR 中
- 版本权威:本仓 gitlink `deps/development-guidelines` @ `a15db5085585`(完整提交 `a15db5085585f199c3c399824f6cf24c3144bbd5`,`0.1.0-draft.14`,Guidelines PR #11);可读标签:无;版本以该提交的 VERSION 为准,历史固定版本见 [policy/adoption.md](adoption.md)
- 批准/生效依据:Dev PR #602 已合入(merge `f563ed612a9574e798ee3421c010a9e2ceb416a0`),证据、Review 与 CI 记录见归档卡 `.task/archive/feature-governance-v2-closeout.md`;当前固定版本随 feature/norm-remediation 交付
- 替代范围和迁移说明:无。既有 [policy/adoption.md](adoption.md) 的逐条决策保持不变,本文件不替代其内容。
逐条规范的采纳、不适用理由与执行方式以 [policy/adoption.md](adoption.md) 为准,本文件不重复其表格。
本仓 `make task-*`(`scripts/task.sh`、`scripts/task_triage.py`、`scripts/task_pr_check.py`)仍是权威任务生命周期;
`scripts/task` 只是 DM 共享入口,供不含 `task.sh` 的仓库使用,本仓不以它替代 `make task-*`。
本文件由 kit 要求的采纳入口只登记以下一行,其余规范沿用 [policy/adoption.md](adoption.md):
| 规范/工作流 | 适用条件与范围 | 采纳或不适用理由 | 执行方式/证据 |
|---|---|---|---|
| [standards/agent-execution.md](../deps/development-guidelines/standards/agent-execution.md) | 工程 Agent CLI 执行路由、会话隔离与受控集成 | 凡允许 AI 协助必须采纳;配置见 `AGENT-EXECUTION.md` | advisory:`AGENT-EXECUTION.md` + `scripts/agent-exec`(validate / admit;本地完整性记录属 SELF);draft.14 起含有界单元包、上下文与阶段交接,项目只配置模型偏好;CI 步骤「Validate AGENT-EXECUTION.md with the pinned shared executor」与「Governance check with the pinned kit」(`scripts/dm governance check --repo .`)。分支保护要求 governance check 为必需检查之前,不宣称为强制(enforced)门禁 |
## 项目差异
无。项目差异(如有)以 [policy/adoption.md](adoption.md) 的「项目差异」节为准。
## 本次升级或首次接入验证
- 入口:根目录 `AGENTS.md`、`PROJECT.md`、`AGENT-EXECUTION.md`、`scripts/dm`、`scripts/task`、`.task/templates/task-card.md`。
- 相对链接:规范文档统一经 `../deps/development-guidelines/...` 引用;本仓内文档使用仓内相对路径。
- 版本获取:`deps/development-guidelines` gitlink 固定于上文版本;`deps/development-manager` gitlink 固定于 `6c019595fa02aa2d0a1a9b8f98fc224e69d2a901`(Development-Manager PR #27,首次采纳时为 `0552b7358d69`),由 `scripts/dm` 按该提交构建共享 dm-server。
- 验证:首次接入时 `scripts/dm governance check --repo .`、`scripts/agent-exec validate --repo .`、正例与四类负例及 `make test-governance` 的 SELF 结果见归档卡 `.task/archive/feature-governance-v2-closeout.md`(摘要见 [policy/adoption.md](adoption.md#采纳证据与未运行项)),不作为当前 exact-head 证据;当前固定版本以交付 PR 当前 HEAD 的必需 CI 为准。