52 lines
2.3 KiB
Markdown
52 lines
2.3 KiB
Markdown
# 场景示例（可直接套用）
|
||
|
||
## 示例 1：空仓库快速落地
|
||
- 输入：
|
||
```json
|
||
{
|
||
"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：功能迭代—登录与刷新
|
||
- 输入：
|
||
```json
|
||
{
|
||
"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. 检查清单提示下一步需用户提供证据。
|
||
- 预期：完整可落盘模板，不含任何凭空事实。
|