mesalogo
2f1881a414
Define repository and feature-scoped documentation rules for PRDs, User Stories, logic, UI, technical design, and progress evidence. Move feature-owned documents under docs/features, add one entry point per feature, remove the redundant docs index, and update all affected cross-references. Expand the local tool environment design with explicit product, story, logic, UI, technical, and progress documents.
本机工具环境
本目录是 GoodBuddy“本机工具环境”功能的唯一文档入口。该功能为本机 SKILL 和本机 stdio MCP 提供明确、可诊断的 Node.js 与 Python 环境，同时允许专业用户选择自己维护的 解释器。
本功能不作用于 SSH Host 上的 GoodBuddy Agent、固定 Node、签名 Runtime、SKILL 或 MCP。
文档导航
| 文档 | 权威职责 |
|---|---|
| PRD | 用户问题、产品目标、范围、需求和产品验收 |
| User Stories | 用户角色、使用场景和逐故事验收 |
| 功能逻辑 | 不变量、状态机、决策表、失败恢复和跨场景一致性 |
| UI 设计 | 页面结构、组件、状态、文案和无障碍一致性 |
| 技术设计 | Main、Runtime、MCP、打包、生命周期和测试架构 |
| 功能进度 | 已完成、进行中、待实施、阻塞项和验证证据 |
术语
| 术语 | 定义 |
|---|---|
| 本机工具环境 | GoodBuddy 在桌面所在设备上向本机 Runtime 和 stdio MCP 提供的工具命令环境 |
| GoodBuddy 托管 | 由 GoodBuddy 提供、验证并解析的 Node.js 或 Python |
| 自定义环境 | 用户从检测结果中选择或直接指定的外部解释器 |
| 工具就绪 | 解释器及配套命令通过真实诊断 |
| 能力依赖就绪 | 某个 SKILL 或 MCP 所需的第三方包和入口通过实际验证 |
文档维护规则
- 产品范围只在 PRD 定义，其他文档链接引用。
- 界面视觉和交互只在 UI 设计定义，并服从仓库根目录的 统一界面设计系统。
- 状态转换、优先级和冲突决策只在功能逻辑中定义。
- 进度文档只记录已验证事实，不复制未来设计。
- 技术实现变化先更新技术设计；用户行为变化同时更新 PRD、User Stories、功能逻辑和 UI 设计。
- 每次完成功能阶段后立即更新进度、验证命令和剩余阻塞项。