用途:产出可长期复用的 Markdown 可行性研究,既供人阅读,也可被下游 Functional Planner 消费。单个受限 YAML 块承载机器事实,叙述部分保留证据、解释与上下文。
主要能力:确认目标、决策边界、范围与输出路径;为研究概念、修订、条目概念、条目修订及关系分配 UUIDv4 URN,身份不派生自标题、类、路径或内容;记录能力、约束、假设、发现、风险、依赖、决策、证据、缺口与非目标,保留不确定性;记录生命周期与来源,重分类保留概念身份并新建修订,拆分、合并、派生、撤回与取代保留显式谱系;写入或更新唯一的 FEASIBILITY-STUDY-INTERCHANGE YAML 块;用 scripts/validate_feasibility.py 校验受限 YAML、JSON Schema 2020-12 结构、语义闭包、修订谱系、墓碑与叙述锚点;研究定稿后生成 feasibility-to-prd-handoff.md 描述的交接件,材料修订后需重新生成。
使用方式:先确认问题定义、期望结果与需支持的决策,收集数据访问、发现、架构、探索、预处理与实验证据,以及风险、隐私、负责任 AI、性能与运维证据;修订既有研究时需提供先前修订与条目身份登记。发布修订前执行 uv run python scripts/validate_feasibility.py <study.md>。
限制:研究不分配 FR-### 或 NFR-###,display_ref 仅用研究本地、类型中立的 FS-### 别名;受限 YAML 块是机器事实权威,交接件为派生摘要,冲突以研究为准;交接件不含版本常量与内容哈希,新鲜度由 study_revision_id 判断;下游 Functional Planner 采用属独立工作流,本包不声称当前直接兼容;下游消费者对研究只读;不声称符合 SpecIF、OSLC RM、ReqIF、PROV、DCMI 或 JSON-LD;YAML 须 JSON 兼容,不使用别名、锚点、合并键、自定义标签或原生时间戳对象。遇到问题或期望结果含糊、标准或证据无法确立、需改概念 ID、需删除撤回概念或需下游回写时应停止并记录。