cs-req

cs-req 启动必读 动作前先跑 CodeStable preflight：读 .codestable/attention.md （缺失先 cs-onboard ）；不要用 AGENTS.md / CLAUDE.md 等外部入口代替它；细则见 .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 。 Show more Installs 76 Repository codestable/codestable GitHub Stars 1.1K First Seen Jul 14, 2026 Security Audits Gen Agent Trust Hub Pass Socket Pass Snyk Warn