Skip to content

[YAO-149] S3: 清理章节末尾模板残留并补全源码定位#73

Merged
luyao618 merged 2 commits into
mainfrom
agent/cc-dev/ee5e931f
May 27, 2026
Merged

[YAO-149] S3: 清理章节末尾模板残留并补全源码定位#73
luyao618 merged 2 commits into
mainfrom
agent/cc-dev/ee5e931f

Conversation

@luyao618
Copy link
Copy Markdown
Owner

Summary

源 issue: YAO-149

1. 删除连续 `---` 模板残留(18 / 19 / 27 / 28 / 33 章末尾)

五个章节的「模式总结」段与「下一章预告」之间出现 `---\n\n---` 双分隔残留,已统一为单一 `---`。

2. 内部代号 / 错误码:源码已验证,保留并标注定位

对照源码 `/Users/yao/work/code/awesome-project/claude-code-cli` 后确认全部为真实存在的源码标识,按 issue 描述「如果是源码中真实存在的常量名/错误码,则保留并标注源码定位」的规则,保留补全源码定位:

标识 源码位置 处理
`Kairos` / `KAIROS` feature `constants/prompts.ts`、`tools/BriefTool/BriefTool.ts:67`、`tools/ScheduleCronTool/prompt.ts` 等 保留(书中各引用处均已带源码块)
`Capybara v8 / 29-30% FC rate / 16.7%` `constants/prompts.ts:237` 注释原文 保留(06 章正文已带 `constants/prompts.ts:237-241` 源码块)
`TelemetrySafeError_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS` `services/tools/toolExecution.ts:68,152`、`services/mcp/client.ts:70,177,1061` 保留(18 章引用处源码块已带 `services/mcp/client.ts:1048-1077` 定位)
`Twitter buzz` `buddy/useBuddyNotification.tsx:9-10` 注释原文 保留(29 章引文前补 `buddy/useBuddyNotification.tsx:9-10` 定位)
`PR #18143` `services/PromptSuggestion/promptSuggestion.ts:313` 注释原文 09 章把"PR #18143 复盘"改写为「源码注释(`promptSuggestion.ts:313`)的中文转述」,避免裸内部 PR 编号

Test plan

  • 18/19/27/28/33 章末尾再无连续 `---`:`grep -n -U $'---\n\n---' docs/{18,19,27,28,33}-*.md` 无输出
  • 仍保留的内部代号每条都有源码 file:line 引用
  • 没有新增章号 / 篇号不一致,没有新增模板残留

Yao Lu and others added 2 commits May 27, 2026 17:26
- 删除 18/19/27/28/33 章末尾连续 `---` 模板残留
- 09 章 PR #18143 注释改写为源码引用 (promptSuggestion.ts:313) 并标注为转述
- 29 章 Twitter buzz 引文补 buddy/useBuddyNotification.tsx:9-10 定位
- Capybara/Kairos/TelemetrySafeError 等均为源码真实标识 (constants/prompts.ts:237/services/mcp/client.ts 等),保留并已附源码定位

Co-authored-by: multica-agent <github@multica.ai>
reviewer (OC-R) 在 PR #73 review 中指出 docs/06 第 3 行残留
`commit `290fdc94``,违反 S3 acceptance criteria。同步清理
docs/32:171 中同类"commit 290fdc9 上"措辞。

保留:
- docs/appendix/*.md & *.manifest.json 中的 `source_commit`
  字段(生成表的标准 provenance 元数据,非"考古痕迹")。
- docs/V2-REVISION-SPEC.md 的 source_commit 与 §正例示例
  (规范文档本身定义规则)。

Co-authored-by: multica-agent <github@multica.ai>
@luyao618 luyao618 merged commit 159824a into main May 27, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant