2.3 KiB

Raw Blame History

场景示例（可直接套用）

示例 1：空仓库快速落地

输入：

{
  "project_root": "~/project",
  "docs_root": "~/project/docs",
  "output_mode": "patch_diff",
  "change_type": "baseline",
  "scope_hint": "docs 为空",
  "use_git_diff": false
}

操作：
1. A：tree -L 2 docs 为空 → 记录证据。
2. B：盘点表全部标记“缺失”；计划新增 docs/README.md、guides/getting-started.md、development-workflow.md、integrations/<待确认>.md。
3. C：输出补丁，命令/端口/变量均标【待确认】，并说明从 .env / docker-compose / 配置目录查证。
4. D：摘要列出新增文件；检查清单提示需补全端口/env/API 证据。
预期：可直接应用的 diff；无臆测字段；每文含 Changelog。

示例 2：功能迭代—登录与刷新

输入：

{
  "project_root": "~/project",
  "docs_root": "~/project/docs",
  "output_mode": "patch_diff",
  "truthfulness_mode": "strict",
  "change_type": "feature",
  "scope_hint": "auth 登录 & token 刷新",
  "related_paths": ["services/api/auth", "services/api/routes"],
  "use_git_diff": true
}

操作：
1. A：git diff --name-only 聚焦 auth 路由/控制器；提取请求/响应字段与错误码。
2. B：盘点表标识 features/prd-auth-login.md、spec-auth-login.md 缺失；integrations/auth-api.md 疑似过期（字段不一致）。
3. C：新增 PRD/Spec；更新 integrations 文档含鉴权方式、错误码、验证 curl；token TTL 等未证实字段标【待确认】并指向配置文件。
4. D：摘要列出新增/更新；检查清单包含“对照 auth/config 复核 TTL、错误码”。
预期：diff 覆盖 3 个文件；所有事实有路径；待确认项附验证方法。

示例 3：无法读取仓库的降级

输入：自然语言 “帮我生成 SSOT 文档模板”。
操作：
1. 归一化 JSON，声明“无法真实扫描，进入 strict 模板模式”。
2. 盘点表说明证据缺口（目录树/README/依赖/配置/API 位置缺失）。
3. 计划仅生成模板；待确认清单列出需用户补充的命令与文件。
4. 输出 full_files：六大目录的骨架文档，字段均标【待确认】+ 如何获取。
5. 检查清单提示下一步需用户提供证据。
预期：完整可落盘模板，不含任何凭空事实。