用途:把用户的模糊想法转成一份完整、独立的项目规格文档,文档只描述 WHAT 与 WHY,不涉及 HOW。硬性限制是不写代码、不做实现计划、不搭建项目骨架,只产出 spec;无论项目看似多简单都走同一流程。
主要流程:检查是否存在 .beagle/concepts/<slug>/brief.md,若有则吸收该简要说明并跳过大部分探索与提问;否则探索项目文件、文档、git 历史与既有 spec;对既有代码库(brownfield)执行中立的“先例检查”,跨整个工作区用能力关键词搜索,确认该能力是否已存在,若已存在则围绕差距重写规格并记录为 Key Decisions,必要时标注 Spike required;评估范围,过大则拆分并为第一个子项目单独 brainstorm;随后一次一个地提问澄清(动机、具体化、成功标准、边界),提出 2-3 个高层产品方向及取舍,起草规格,自审(占位符、矛盾、实现泄漏、可测试性、范围、重复造轮子),用户复核后写入磁盘。
规格包含:Core Value、Problem Statement、Requirements(must/should/out of scope)、Constraints、Key Decisions、Reference Points、Open Questions、Future Considerations。要求必须具体可测,例如“用户可撤销最近 10 次操作”,而非“良好的撤销支持”。终止状态是写入规格文档,之后由用户决定用途,技能不转入实现或规划。
限制:依具体项目而定,是否基于对话一问一答推进、是否需要先例检查视项目类型而定;官方未提供更多关于安装方式、收费或平台的信息。