研发团队 AI-native
开发实战指南
代码生成提速后，以可验证性、工程化与人机协作为核心，让多源知识持续转化为有效测试、技能和交付能力。
术语约定：验收标准（Acceptance Criteria，简称 AC）；正文与图表优先使用中文，AC-1 等稳定编号保留。
整合方向：人掌握目标、正确性、系统约束、风险与接管，机器承担有界执行和分层验证；每次失败推动知识与工程能力改进。
复用 IDP、Egress、FSpec、feeds、bug-finder 与 repo-wiki 的已有经验。源码、Bug、复盘、需求和反馈定期增量沉淀，结论经过核验后进入回归、评测和能力发布。
udobj 有效知识迁入 ai-wiki；bug-finder、Golden Path 与业务仓各自维护实现，通过 fs-ai-hub / TeamAI 统一发布。
接入卡、日常剧本和棕地改造按团队能力推进，Linux、浏览器与移动端运行资源分别适配。
16 类内部踩坑映射为失败验收；对照 Stripe、Spotify、Uber 等实践，保留适用限制与人工残余工作。
阅读边界：本报告基于本地文件、远端文档和部分源码核对。未实跑公司部署环境、完整业务测试或迁移流程。方案与示例契约为待评审建议；“上游已支持”不等于公司版本已启用。报告含内部工程名称和规范，源码链接仍需相应访问权限。
章节目录
01 从已有实践走向可复制交付 实践 / 建议 从已有实践走向可复制的研发方式 你们已经具备知识聚合、技能分发、规格驱动、任务编排、独立验证和诸葛运维入口。 下一步最有价值的工作，…
02架构、流程与人机泳道实践 / 建议02 架构、流程与人机泳道 实践 / 建议 架构与流程：五个责任面，一条可验收交付链 知识回答业务和规则，技能描述可重复执行的方法，平台管理任务和运行，项目承载实现， 独立验证确认…
03知识、技能与项目上下文实践 / 建议03 知识、技能与项目上下文 实践 / 建议 知识、技能、项目上下文各放哪里 先确定唯一维护源，再讨论目录 内容与变化原因 唯一维护位置 使用方式与边界 公司规范、稳定业务语义、跨…
04三个协作空间与 Feature 文档生命周期V8 更新04 三个协作空间与 Feature 文档生命周期 V8 更新 Feature 工作文档的存放、版本与失效治理 补充日期：2026-11-08。结合 GitLab Issue SS…
05研发阶段、命名规范与新材料实践对照V10 更新：team / domain05 研发阶段、命名规范与新材料实践对照 V10 更新：team / domain 研发阶段、GitLab 命名与按类型推进的规范建议 更新日期：2026-11-08。以下为可评审…
06组织分层、冲突与例外实践 / 建议06 组织分层、冲突与例外 实践 / 建议 公司、团队、岗位、项目：把差异变成可检查的配置 六种身份分开登记 业务项目可以包含多个团队和仓库；Multica Project 当前默…
07技能与能力包发布实践 / 建议07 技能与能力包发布 实践 / 建议 能力库发布：把 Skill 当作有版本的工程资产 延续 fs-ai-hub 设计，补齐从源到运行的链路 推荐链路为：唯一源码 → 检查/评测…
08团队接入与部门运行时实践 / 建议08 团队接入与部门运行时 实践 / 建议 团队接入与部门 Linux 运行时 团队接入需要一张可执行卡片 下表为建议的最小接入卡，复用已有目录与平台配置；没有这些事实的工程先补事…
09日常研发操作剧本实践 / 建议09 日常研发操作剧本 实践 / 建议 日常研发：从一句需求到可合并 MR 剧本 A：单仓小需求 建议以 IDP 的 Issue/EARS 方式作为轻量参考。 产品/开发可在 Mu…
10诸葛巡检到修复闭环实践 / 建议10 诸葛巡检到修复闭环 实践 / 建议 诸葛自主巡检到修复：让每一步都有证据 从已记录的值班做法起步 bug-finder 将巡检、RCA、影响评估分为独立入口；跨域 RCA 由…
11棕地项目现代化实践 / 建议11 棕地项目现代化 实践 / 建议 棕地项目现代化：先让改变可验证，再扩大自主范围 按工程能力分批，而不是一次性改造 500 个仓 现状分组 第一笔投入 Agent 可承担的工作…
12测试、可验证性与证据实践 / 建议12 测试、可验证性与证据 实践 / 建议 可验证性：产品行为、测试有效性、证据可信度一起建设 开发 Agent 自验、CI 扫描与独立验收协作 用户于 2026-11-08 补充…
13人机验证、批判性思维与人的责任V11 更新：防止认知投降13 人机验证、批判性思维与人的责任 V11 更新：防止认知投降 人机验证协作：人在环内、监督环路与环外的责任 更新日期：2026-11-08。本章为结合现有公司实践提出的组织与工…
14项目可观测、诊断与部署闭环实践 / 建议14 项目可观测、诊断与部署闭环 实践 / 建议 工程化与可观测：把可靠步骤交给确定性执行器 每个项目应交付可观测入口、Grafana 关联、debug/deploy 技能及指南，…
15踩坑指南与失败验收实践 / 建议15 踩坑指南与失败验收 实践 / 建议 踩坑指南：把已发现的差距转成验收用例 下表来自本轮文件/源码核对及仓内案例。它们是具体缺口或风险，不代表本次实际发生生产事故。 症状 已有…
16业内实战对照实践 / 建议16 业内实战对照 实践 / 建议 业内一手实战：能复用什么，不能照搬什么 对照公司已有工作 一手案例 原文核实的做法 公司对应资产与推荐动作 适用限制 Stripe Minion…
17推广、度量与接管实践 / 建议17 推广、度量与接管 实践 / 建议 推广、度量与接管：用实际通过条件扩大自主权 成熟度与自主程度分别管理 工程成熟度 晋级证据 建议自主范围 M1 可识别 责任、仓库、服务、知…
18形成持续维护的公司经验实践 / 建议18 形成持续维护的公司经验 实践 / 建议 让这份指南成为持续维护的公司经验 本报告建议先作为待评审手册，评审后按主题落到 ai-wiki 的现有规范与领域入口。 可执行 Ski…
19附录：118 篇迁移分类与目录迁移盘点19 附录：118 篇迁移分类与目录 迁移盘点 迁移资产盘点 按本地文件统计，源库共 118 个 Markdown： 分类 文件数（含目录说明与模板） 价值与处理重点 00-pla…
20来源、版本与核验范围证据20 来源、版本与核验范围 证据 来源、版本与核验范围 调研日期：2026-11-06。公开上游按当次 API 返回的 main SHA 固定；本地仓按当前 checkout 读取…