更新 Wiki 技能
刷新 Wiki 页面中手写的散文部分,以反映代码库的当前状态。由协调器(orchestrator)管理的生成指标/数据块绝不应当被触及。
何时调用
- 用户输入
/update-wiki— 更新所有包含散文块的页面 - 用户输入
/update-wiki Architecture— 仅更新wiki/Architecture.md - 用户说“刷新 wiki 散文”、“更新入门叙述”、“重写架构文档”
- 在重大重构更改了系统设计叙述之后
此技能的工作步骤
-
确定范围。 如果提供了页面名称参数(例如
Architecture),则解析为wiki/{PageName}.md。否则,对下方列出的所有包含散文块的页面进行排队。 -
对于每个目标页面: a. 读取 Wiki 页面文件。 b. 识别每个
<!-- claude:prose -->...<!-- claude:prose:end -->块。 c. 读取下方页面注册表中列出的相关源文件以构建上下文。 d. 重写标记之间的内容,使其准确反映当前代码库 — 保持相同的一般结构(标题、段落顺序),除非事实错误。 e. 将更新后的内容写回文件,同时精确保留标记。 -
绝不触及生成的块。
<!-- generated:start -->...<!-- generated:end -->内的任何内容都必须保持字节级一致。这些块由 Wiki 协调器脚本维护。 -
架构决策日志完全由 Claude 拥有。
wiki/Architecture-Decision-Log.md没有generated块,也没有claude:prose标记。Claude 维护整个文件。更新时,为自上次记录条目以来做出的任何架构决策追加新的 ADL 条目。请勿修改现有条目。 -
提交提示。 所有页面更新后,提醒用户:
“Wiki 散文已更新。运行
/commit保存更改,然后推送到 Wiki 远程仓库。”
包含散文块的页面及其源文件
wiki/Architecture.md
散文块目的: 系统设计叙述 — 解释模块职责、数据流,以及静态站点 + Lambda 聊天代理如何协同工作。
要读取的相关源文件:
WebContent/js/main.jsWebContent/js/filter.jsWebContent/js/carousel.jsWebContent/js/utils.jslambda/lambda_function.pyindex.html(用于页面结构上下文)projects.html(用于页面结构上下文)
wiki/Lambda-Chat-Agent.md
散文块目的: 代理设计原理 — 解释 Lambda 架构、知识库加载、提示构建和响应处理。
要读取的相关源文件:
lambda/lambda_function.pylambda/context/(如果存在,所有.md文件)
wiki/Contributing.md
散文块目的: 新手入门叙述 — 为新贡献者解释开发工作流、测试理念和项目约定。
要读取的相关源文件:
CLAUDE.mdMakefilepackage.jsonpyproject.toml.github/workflows/ci-cd.yml
wiki/Architecture-Decision-Log.md
特殊处理: 没有 claude:prose 标记。Claude 拥有整个文件。追加新的 ADL 条目;切勿修改现有条目。
要读取的相关源文件:
- 查看最近的 git 日志以了解重要的架构更改
CLAUDE.md了解当前工具决策lambda/lambda_function.py了解后端决策
标记保留规则
<!-- claude:prose -->
[Claude 重写此内容]
<!-- claude:prose:end -->
<!-- generated:start -->
[绝不触及 — 由协调器管理的数据]
<!-- generated:end -->
- 起始和结束标记必须单独成行,且保持不变。
- 不要在标记内部立即添加额外的空行。
- 不要嵌套标记。
警告
切勿修改 <!-- generated:start --> ... <!-- generated:end --> 块。
这些块包含由 Wiki 协调器生成的自动指标和表格。修改它们将导致下一次协调器运行时产生合并冲突或静默覆盖您的更改。