Project Setup
从 AGENTS.md 到 workflow 的最短路径
如果你是第一次把 AI Coding 接进项目，直接走这条最短路径。
Quick Path
- 先安装 Agents Markdown
- 让 Agent 从
.ai-coding/ENTRY.md启动初始化 - 再补 AC Skills 或项目级
.agents/skills/* - 设置项目默认开发偏好：
TDD first - legacy backend / 生产服务 / 对外契约变更，执行前先走
Preflight - 执行任务时，用
PROJECT_STATE.md和 workflow triad 保持上下文稳定
Decision Table
| 任务类型 | 默认路径 | TDD Mode | 额外门禁 |
|---|---|---|---|
| 新前端页面、文档、低风险 UI 集成 | Safe Path | strict-test-first | 正常 review 和验证 |
| registry 维护、站点内容改动 | Safe Path | strict-test-first | 保持改动边界清晰 |
| legacy backend、生产服务、对外契约 | Guarded Path | 先默认 strict-test-first，必要时降到 evidence-first-targeted-tests | Preflight + 明确 rollback + 必要时人工验收 |
| 高风险 agent-authored 改动 | Guarded Path | 按风险重新确认 | needs-human-acceptance 后才可放行 |
Core Assets
Agents Markdown
生成 AGENTS.md、模板文件和初始化流程，适合新项目直接起步。
AC Skills
如果你已经有自己的协作文档，只想复用 workflow / role skills，就从这里补。
Further Reading
Guarded Path
以下场景默认进入 Guarded Path：
- legacy backend
- 生产服务改动
- 对外契约变更
- 高风险 agent-authored 结果
Guarded Path 的执行前门禁：
- 先做
Preflight - 明确
TDD Mode - 如果
Human Acceptance Required=true，最终必须人工验收后再放行