SuperAPI AI 工具集

cs-req

办公与效率

查看项目

更新于 10-15 20:30

技能介绍

cs-req 是 CodeStable 工作流中负责能力愿景维护的技能,核心是维护 .codestable/requirements/ 目录下的需求文档——描述一个能力因什么问题产生、怎么解决、边界在哪,面向非技术读者。每份文档用 status 字段区分三种时间深度:draft(尚未实现的未来愿景)、current(正在满足的现在能力)、outdated(已移除或不再维护的过去痕迹)。

主要用途分三种模式:draft 为还没实现的新能力起草愿景;backfill 为已在运行但从未写档的能力补写,直接落 current;update 按新素材或实现变化刷新已有文档。每次只处理一份文档,单个 req 只描述一个能力。纯内部重构、技术债清理、工具链改造等不新增用户可感能力的 feature 不强制写 req。

使用流程分六阶段:锁定目标(模式、目标文档、范围);读取材料(VISION.md、其他 req、用户素材,按需读 architecture doc 和 compound 沉淀);一次性起草完整初稿;跑自查清单(语气是否人话、标题是否平铺、用户故事是否具体、有无实现细节、边界是否写明、pitch 能否当宣传词);用户 review 直至通过;落盘并更新 VISION.md 索引。文档结构包含 frontmatter(doc_type、slug、pitch、status、last_reviewed、implemented_by、tags)和四节正文:用户故事、为什么需要、怎么解决、边界。update 模式还需变更日志,draft 升级为 current 属结构性改动必须记录。

适用场景包括 brainstorm 后愿景清晰时触发 draft、feature-design 首次方案化时起草愿景、feature-acceptance 验收后升级或回填、用户主动盘点或修订。与其他技能关系:cs-domain 管术语与 ADR,cs-roadmap 管分步实现,cs-onboard 创建目录,cs-feat-accept 是 draft 转 current 的主路径。

硬性边界:一次只动一份文档;不写实现细节,涉及实现的移到 architecture;不替用户编造用户故事;不改代码和 architecture doc;不发散。启动前需先执行 CodeStable preflight:读 .codestable/attention.md,缺失先 cs-onboard。具体收费、平台等信息暂未提供。