cs-req
Installation
SKILL.md
cs-req
启动必读
开始任何判断或动作前,先执行 CodeStable preflight:读 .codestable/attention.md;缺失先 cs-onboard;不读外部 AI 入口替代(详见 .codestable/reference/execution-conventions.md)。
.codestable/requirements/ 是项目的"能力清单"——每份描述一个能力因什么问题而产生、怎么解决、边界在哪,写成人话非技术读者也能看懂。架构文档讲"怎么搭",需求文档讲"为什么要有"。
req 是系统的能力愿景层——描述"用户需要什么、系统提供什么能力来满足"。三层时间深度用一个 status 字段区分:
draft:用户有这个需要,系统还没实现(未来愿景)current:系统正在满足(现在的能力)outdated:曾经满足过,现已移除或不再维护(过去的痕迹)
draft req 可以独立于实现存在——用户说"我想要 X 能力"但还没想好什么时候做,可以先落一份 status: draft 的 req 把愿景定下来,后续 roadmap 排期、design 对齐时都有稳定参考。不做 roadmap 规划不等于不该有愿景文档。
draft → current 的主路径是 feature-acceptance:能力实现完成、验收通过后,acceptance 触发 cs-req update 把 status 从 draft 改为 current,同时按实际实现刷新用户故事 / 边界(保留原始愿景不被覆盖,只在文末加变更日志)。
backfill 路径保留:已经在跑但从没写过 req 的能力,走 backfill 直接落 status: current。