OpenSpec 生成文件说明
proposal.md——为什么做、做什么产品/范围Why要解决什么问题、机会是什么。What Changes会新增/改掉/删掉哪些能力有没有BREAKING。Capabilities会动到哪些能力名对应后面specs/名字/哪些是新能力、哪些是改已有能力。Impact会影响哪些模块、接口、依赖。作用定方向与边界让后面 spec/design/tasks 不跑偏。design.md——怎么做技术方案Context / Goals / Non-Goals背景和明确不做的。Decisions关键技术选型例如 Cookie 会话 vs JWT、取舍理由。Risks / Migration / Open Questions风险、上线/回滚、还没拍板的事。作用解释实现思路不写逐行代码和proposal的「为什么」、spec的「对外行为」区分开。spec.md常在specs/能力/spec.md——系统应该怎样表现可验收用Requirement ScenarioWHEN/THEN描述行为。对已有能力用 deltaADDED / MODIFIED / REMOVED等。作用测试与评审的依据——「做到什么算对」实现细节放在design和代码里。tasks.md——谁按什么顺序干活实现清单分组的- [ ]/- [x]checkbox给 apply 阶段追踪进度。作用把 spec/design拆成可执行步骤和 spec 对齐改需求时往往也要改这里。一句话串起来proposal定价值与范围 →spec定行为与验收 →design定技术路线 →tasks定落地顺序与勾选。
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/2456316.html
如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!