Repository navigation
Releases
Releases · Cunzhang0703/req-interview-skill
v1.1.0 · 提示词增强与需求判断
req 1.1.0 · 先增强提示词,再判断需求
在原有双宿主版本上,新增访谈前的提示词拓展与增强流程。
修复
- 恢复源文件口径:撤销未经实测的「待确认 → 待决定」行为改动。图示未知项继续标记为
「待确认」,决策记录继续使用「待决定」;两个版本的图示标记均恢复为原始源文件口径。
新增
scripts/check-skill.sh:零依赖完整性校验脚本。把 CONTRIBUTING 的双版本同步规则从
「人眼看 diff 数差异块」变成可执行断言——先按内容特征归一化允许差异的位置,再比对两版全文,
因此插入或删除无关行不会误报,只有清单外的真差异才失败;同时校验结构不变量(章节数、§7 七条、
§4 八视角、五态措辞)、图标一致性、行尾与技能正文卫生。.github/workflows/check-skill.yml:每次推送与 PR 自动运行上述脚本。
变更
- 两版技能的第 1 步调整为「先增强提示词,再判断范围」:整理原意、场景、结果和约束,
将可能理解与关键缺口分别接入「AI 建议」和「待决定」,再判断是否需要访谈。首轮直接复用
增强理解,不另设审批;保留明确的小修改、普通问答、已确认需求的轻量路径及用户拒绝改写的选择。 - 同步 README、设计说明、安装后的验收说明、访谈示例和验收场景,使文档体现新的执行顺序。
修改前后首轮文本试跑见 评估记录;两个平台的完整实机回归仍待完成。 - README 结构树补上
scripts/;「纯提示词实现」表述改为「技能本体是纯提示词实现」,
以免与仓库自带的维护脚本混淆。 - CONTRIBUTING 的自查方式改用校验脚本,并说明为什么不能人眼数差异块:两版实际有 6 个
差异块而非 4 个(§3 那条落在 3 行上)。
GitHub 校验:合并提交的 完整性检查已通过,FAIL=0 / WARN=0。
安装方式沿用原版,见 README。WorkBuddy 与 Codex 请各选对应目录安装。
v1.0.0 · 双宿主首版
req 1.0.0 · 双宿主首版
首次公开发布,双宿主版本一次交付。
新增
req-workbuddy:WorkBuddy 安装版。第 3 节把宿主原生结构化提问工具(AskUserQuestion)指定为
本技能唯一的提问方式;第 8 节同样用它收集范围确认。req-openai:OpenAI Codex / ChatGPT Skills 安装版。提问方式放宽为「优先用宿主原生提问工具,
没有就用普通中文提问」;附带agents/openai.yaml声明显示名称、启动提示与隐式调用开关。- 九节行为骨架:范围与边界 → 先理解再提问 → 分轮追问 → 查漏视角 → 决定权划分 → 需求可视化 →
收口标准 → 需求简报与确认 → 交接与退出。 - 需求图示交付规则:需求思维导图 + 功能架构图,Mermaid 对话展示与独立 SVG 文件双交付,
待确认项与 AI 建议必须显式标注,不得与已确认内容混淆。 - 需求简报模板,含「用户已确认/AI 建议/授权默认项/待决定/待验证」四类状态区分。
- 五态决策记录:用户已确认/证据已核实/AI 建议/待决定/暂不做。
设计取舍
- 纯提示词实现:无脚本、无依赖、无网络请求,
SKILL.md可整份通读审计。 - 不使用虚构的成熟度指标:以 7 条可检查的收口条件替代「需求成熟度 95%」这类无法验证的说法。
- 不接管后续流程:需求确认 ≠ 开发计划确认,且不宣称已切换计划模式。
安装:见 README。两个版本只装一个,不要装进同一平台(name 都是 req)。
完整更新记录见 CHANGELOG.md。