Skip to content

Releases

v1.1.0 · 提示词增强与需求判断

Choose a tag to compare

@Cunzhang0703 Cunzhang0703 released this 22 Sep 10:22
16e2838

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 · 双宿主首版

Choose a tag to compare

@Cunzhang0703 Cunzhang0703 released this 19 Sep 15:14

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。