BitFun 可配置开发体验追踪矩阵
June 12, 2026 · View on GitHub
范围:把产品需求、架构设计、功能规格、执行阶段和测试方法连起来,避免关键体验只停留在单份文档中。 上游文档:product-requirements.md、design.md、implementation-plan.md
| 关键点 | 产品需求 | 设计承接 | 功能规格 | 执行阶段 | 测试方法 |
|---|---|---|---|---|---|
| 默认低摩擦 | PRD-01、PRD-02 | 快速路径轻量、体验投影层 | 配置化策略画像、项目画像 | P0 | 质量保障要求较低的探索性改动、无配置项目、文档改动任务回放;统计首次有用动作耗时和低风险任务完成率 |
| 内部策略不外露 | PRD-03、PRD-13 | 体验投影层、用户语言稳定 | 配置化策略画像 | P-1、P0 | 检查桌面、命令行、远程、PR 摘要是否只展示任务状态、原因和下一步,不展示内部枚举 |
| 弱提示和弹窗降噪 | PRD-14 | 提示先弱后强、弹窗触发约束 | 配置化策略画像、质量数据面 | P0、P1 | 同类提示合并/延后用例;统计用户打断率、弹窗触发率、重复提示抑制率 |
| 执行安全常驻 | PRD-04 | 安全边界独立 | 安全边界 | P0 | shell、网络、凭据、删除、跨目录写、hook/MCP 用例;验证 allow/ask/deny/应急放行记录 |
| 沙箱边界可见 | PRD-19 | 执行位置和沙箱等级分层 | 安全边界、质量数据面、证据包 | P0、P1、P3 | 本地 shell、远程 SSH、ACP、MCP、MiniApp、插件适配主机、浏览器/桌面和云端任务用例;验证执行位置、沙箱等级组合、降级原因、授权范围和替代路径 |
| 阶段性用户收益 | PRD-20 | 阶段收益编排、质量一致性检查、阶段风险副作用分析 | 实施计划、指标规格、质量数据面 | P-1、P0-P4 | 每阶段回放低风险任务、安全确认、远程/不可支持状态、PR/团队场景;验证用户收益、技术前置、延期边界、风险副作用、质量一致性和性能预算 |
| 远程开发适配 | PRD-11、PRD-12、PRD-15 | 本地/远程能力边界、项目集成面 | 项目画像、风险分类器、安全边界 | P0、P1 | SSH、容器、远程工作区、云端任务用例;验证执行位置、路径映射、端口/网络、不可支持状态和替代路径 |
| 团队配置治理 | PRD-05、PRD-06 | 配置层级、组织策略优先级 | 配置化策略画像、PR 门禁 | P2 | .bitfun、AGENTS、CODEOWNERS、CI、路径规则冲突用例;验证来源、优先级和覆盖限制 |
| PR 就绪度 | PRD-07 | 证据按需投影、PR 场景显露 | PR 门禁、证据包 | P1、P2 | 准备 PR、受保护分支、不可运行 CI 用例;验证就绪度摘要、未验证项、证据引用和非默认阻断 |
| 复杂项目追溯 | PRD-08 | 交付物图谱、证据可追溯 | 证据包、交付物图谱、需求影响分析 | P3 | 需求变更、发布、事故复盘用例;验证链接来源、新鲜度、人工确认和过期处理 |
| 主动配置信任 | PRD-09 | 项目规则与主动配置分层 | OpenCode 兼容层、安全边界 | P0、P2 | hook、plugin、MCP、自定义工具回放用例;验证来源、hash、权限、触发条件和信任状态 |
| Kernel 扩展点 | PRD-16 | hook、事件、打点、插件效果候选、内核权威状态 | OpenCode 兼容层、质量数据面 | P-1、P1 | 空实现、过期 epoch、重复 event、候选效果丢弃、打点采样回放用例;验证不影响默认任务 |
| 能力/效果模型 | PRD-09、PRD-16、PRD-17 | 能力/效果模型统一、未声明能力受限、策略不写死工具名 | 安全边界、OpenCode 兼容层、质量数据面 | P-1、P0、P1 | tool、MCP、skills、插件、hook、内置工具回放用例;验证能力声明、目标对象、数据类别、信任来源、副作用候选和未知能力受限 |
| 工具复写安全 | PRD-17 | 工具复写显式授权、复写表按项目执行域生效 | OpenCode 兼容层、安全边界 | P1、P2 | 内置工具复写契约、同名工具候选、权限撤销、hash 变化、远程执行主机变化用例;验证复写不跨项目且仍经安全边界 |
| 关键用例体验 | PRD-18 | 体验投影层、页面/面板布局、跨入口语义一致 | 产品需求、配置化策略画像、质量数据面 | P0、P1 | 质量保障要求较低的探索性改动、文档改动、安全确认、PR 就绪、受管路径、远程容器、主动配置回放用例;验证体验变化、用户收益、布局、文案、交互和降噪 |
| 产品指标闭环 | PRD-10 | 质量数据面、评测与学习 | 指标规格、智能体评测 | P0-P4 | 指标采样回放、策略 A/B、保留集;验证速度、打断、安全、质量和成本联合解释 |
文档边界
| 文档 | 回答的问题 | 不承担的问题 |
|---|---|---|
| product-requirements.md | 产品目标、用户画像、平台入口差异、关键边界、功能需求、成功指标 | 不定义模块内部数据结构和实现顺序 |
| design.md | 架构边界、领域模型、配置层级、模块职责和硬约束 | 不重复用户画像、产品规格和阶段任务 |
| implementation-plan.md | 阶段用户收益、必要技术前置、延期边界、验收条件和过程风险 | 不替代产品需求或模块契约 |
| 子模块文档 | 单模块输入、输出、状态、边界场景和成功标准 | 不重新定义产品定位 |
| governance/metrics-spec.md | 指标公式、分母、窗口、负责人和解释边界 | 不直接作为阻断策略 |