AI Coding 工作区

AI Coding 工作区是一种仓库组织方式。它把业务源码、项目协议、文档事实、任务提示词、检查脚本、本机差异和过程证据放到各自的位置，让人和 AI 都能按同一套路线工作。

Seed 不要求你换技术栈。它给现有仓库增加的是协作结构。

工作区分层

区域	典型路径	放什么	怎么用
产品源码	code/	前端、后端、脚本、配置示例。	业务开发和交付主体。
协作协议	.maw/	项目身份、组件、模块、环境、发布、能力和检查策略。	AI 开始任务前读取的结构化事实。
文档事实	docs/	需求、设计、模块档案、验收、交付和使用说明。	人和 AI 都可审阅的事实层。
提示词资料	prompts/	一次性任务提示词、任务包、外部分析草稿。	只在明确任务命中时读取和执行。
检查脚本	ops/	配置读取、测试计划、边界检查、打包和发布脚本。	把验证和发布前检查变成命令。
发布覆盖	release/	发布时随带的覆盖文件和规则。	发布前必须检查脱敏和边界。
本机资料	.local/	本机端口、临时资料、私有覆盖、个人工具差异。	不提交真实内容，只提交 README 或示例。
过程证据	artifacts/、reports/	检查结果、审计报告、发布记录、任务记录。	收口和复盘时引用摘要。

AI 进入仓库时的路线

1. 先读取项目入口和任务相关文档，不全仓漫游。
2. 如果任务涉及页面、接口、表、配置或发布，先定位模块和组件。
3. 如果任务涉及可复用能力，先查能力索引，避免重复造轮子。
4. 如果任务涉及公开、发布或交付，先确认边界和检查命令。
5. 修改完成后记录验证结果、风险和下一步。

人怎么用

你不需要每天维护所有文件。建议按阶段使用：

阶段	最少维护
新项目	README.md、.maw/project.yaml、.maw/components.yaml、.maw/modules.yaml。
第一次 AI 任务	Prompt Spec、允许修改路径、验证命令。
项目变复杂	模块档案、技术地图、项目记忆、检查脚本。
准备公开	脱敏规则、公开边界、release gates、公开 Pack。

最小示例

.
├── code/
│   ├── server/
│   └── client/
├── .maw/
│   ├── project.yaml
│   ├── components.yaml
│   └── modules.yaml
├── docs/
│   └── modules/
├── ops/
│   └── scripts/
└── prompts/
    └── task-packs/

这个结构表达的是：业务代码在 code/，AI 协作事实在 .maw/ 和 docs/，任务入口在 prompts/，验证入口在 ops/。

常见误区

误区	正确做法
把所有规则写进 README	README 只做项目入口，稳定规则拆到 .maw/ 和 docs。
让 AI 每次从零理解项目	把模块、组件、检查和经验沉淀下来。
把本机配置写进公开文档	本机差异进 .local/，公开文档只写仓库相对路径和示例。
把任务包当归档垃圾	Task Pack 应保留恢复状态和验收结果。

下一步

阅读 Prompt Spec，把一次 AI Coding 任务写成可执行输入。