27 lines
1.3 KiB
Markdown
27 lines
1.3 KiB
Markdown
|
|
## Why
|
|||
|
|
|
|||
|
|
这个仓库是一个已经完成开发的老项目,现有代码能够运行,但缺少可持续维护所需的项目文档与正式的 OpenSpec 变更资产。当前维护者需要同时理解路由、页面能力、接口分布、请求封装和历史遗留实现,如果继续在无文档状态下迭代,后续开发和排障成本会持续升高。
|
|||
|
|
|
|||
|
|
## What Changes
|
|||
|
|
|
|||
|
|
- 重新通过命令行初始化 OpenSpec CLI,并把当前仓库接入 GitHub Copilot 可识别的 OpenSpec 工作流。
|
|||
|
|
- 为现有 Vue 项目补齐开发文档,包括项目总览、页面功能说明、接口汇总和工具/约定说明。
|
|||
|
|
- 记录老项目中的关键历史实现特征,例如前端硬编码登录、axios 的下标式 baseURL 选择、请求参数风格混用等。
|
|||
|
|
- 明确哪些页面已启用、哪些页面存在代码但未接入路由或菜单,降低后续误判风险。
|
|||
|
|
|
|||
|
|
## Capabilities
|
|||
|
|
|
|||
|
|
### New Capabilities
|
|||
|
|
|
|||
|
|
- `project-documentation`: 为现有老项目提供结构化的维护文档,覆盖页面职责、接口来源、工具封装和后续维护注意事项。
|
|||
|
|
|
|||
|
|
### Modified Capabilities
|
|||
|
|
|
|||
|
|
- 无。
|
|||
|
|
|
|||
|
|
## Impact
|
|||
|
|
|
|||
|
|
- 影响目录:`.github/`、`openspec/`、`docs/`
|
|||
|
|
- 不影响目录:`src/`、`public/`、构建配置与运行逻辑
|
|||
|
|
- 影响对象:后续维护人员、接手开发人员、基于 GitHub Copilot/OpenSpec 的协作流程
|