How to keep specs consistent and up-to-date with spec-kit?
- 主要語言
- Python
- 星號
- 137k
- 分支
- 12.3k
- 平均合併
- 2 天 13 小時
- 30 天內合併 PR
- 154
描述
With `spec-kit`, each feature defines its own spec. This works well at first, but over time and with the multiplication of features, some descriptions become outdated or are enriched by new features.
## Example
- Feature **001 – User Login** defines that a user can log in with email + password.
- A few months later, feature **009 – Two-Factor Authentication** enhances the login by adding an extra step (OTP code).
In this case, the original spec of feature 001 becomes partially outdated or needs to be complemented by feature 009.
## Discussion
- Is there a recommended approach to **consolidate specs over time**?
- Should the original feature be modified, or is it better to keep the historical record and add links to subsequent evolutions?
- Are there patterns used by the community to manage the evolution and consistency of specs as new features are added?
- **Idea:** Would it be useful to introduce a `/close` command (or equivalent) to mark a feature as deprecated and automatically update a centralized project documentation?
貢獻指南
研究方向
Issue 中沒有確定原始檔案、測試或實作進入點。首先檢視 spec-kit 現有的 feature-spec 工作流程和此處的討論,然後定義生命週期模型、歷史 spec 與目前 spec 的處理方式,以及 /close 命令或集中式文件需要呈現的內容。
由索引模型根據 Issue 內容生成。
評估
- 領域
- documentation
- Issue 類型
- 功能
- 難度
- 5/5
- 預估耗時
- 一週以上
- 活躍度
- 冷清
- 描述清晰度
- 需要釐清
- 新手友好度
- 25/100