1.4 KiB
1.4 KiB
name, description
| name | description |
|---|---|
| requirements | 将技术说明、问题描述、会议材料或现有实现整理为可确认的需求目标、范围、角色、流程、规则、验收标准和疑问。适用于技术内容转需求；技术设计、代码实现或把推断写成已确认业务规则不应触发。 |
需求整理
保留输入事实与来源，区分当前行为、期望行为、建议和待确认项。先识别角色、场景、触发条件、主流程、异常流程、数据、权限、兼容和范围外事项，再生成可测试的验收标准。
技术实现细节只有在构成真实约束时才保留；不能从代码结构反推业务意图。冲突、模糊词、缺失规则和不可测试表述进入疑问清单。默认在对话中展示；用户要求保存时先展示待确认内容，再读取 .craftkit/project.json 的 documents 配置，过程需求使用 workRoot，共享需求使用 designRoot。
落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 .craftkit/standards/document-maintenance.md 更新审核状态；排版和错字修正不改变状态。rnrn写入后在 workRoot/<task>/task.json 登记本次创建、更新或引用的文档及 relationship；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。