跳到主要内容
系列文档 · 第 18 min

第 1 集 - 选定更新和系统边界

正文

这一集先定义任务,再进入 CLI。第一次成功使用 Silan Viking,不应该是“迁移整个网站”,而应该是一项研究更新走完清楚的生命周期:私人内容源、结构校验、明确发布,以及在基础设施可用时再预览或部署。

Using Silan Viking 系列从一个有边界的更新开始,而不是从整站迁移开始。

本集结果

完成这一集后,你应该得到:

  • 一项具体研究结果;
  • 第一次工作流的范围边界;
  • 后续三集都会使用的四状态模型;
  • 判断这项更新是否可以进入私人文章阶段的检查表。

本系列后续使用新建工作区中的 silan CLI。当前安装路径支持 macOS 和 Linux。打包桌面端的首次上手流程仍然和这条 CLI 主线分开。

选择一项更新

只选一项结果。好的候选应该足够小,可以用一页说清楚;也足够具体,让另一个研究者能检查证据:

  • 一个还没有公开解释的项目里程碑;
  • 一个改变原先预期的实验;
  • 一份档案、数据集、benchmark 或 release note 改变了某个 claim;
  • 一条简历表述缺少在线证据;
  • 一个现在只存在于幻灯片里的短技术结果。

不要选择“重做整个研究网站”或“整理所有旧项目”。那是迁移项目。本系列处理的是一项更新如何安全通过系统。

写下发布边界

创建文件前,先用普通语言写清楚边界:

选定更新:
  <一句话说明结果>

公开 claim:
  <审阅后愿意公开说什么>

证据:
  <读者可以在哪里检查支持材料>

不在范围内:
  <旧项目、无关页面、生产部署或自动化>

这个边界会让第一次工作流足够小,也能防止 Agent 或后续编辑把一次窄更新扩大成失控重写。

使用四状态模型

Silan Viking 把内容状态和站点状态分开处理:

private source
    -> validate
    -> publish the item
    -> preview or deploy when infrastructure is available

每个动作的责任和失败模式都不同:

  • 编辑改变普通 Markdown 和 TOML 文件;
  • 校验检查内容源结构,并重建派生索引;
  • 发布把某一项内容的源状态改为公开;
  • 部署更新正在运行的网站或预览栈。

Agent 可以帮助检索上下文或准备提案,但不应该拥有发布权或生产部署权。这两件事继续由本人明确执行。

进入下一集前的检查表

只有当选定更新满足这些条件时,再进入第 2 集:

  • 这项更新能用一两句话说清楚;
  • 证据位置已知,即使最终正文还没写好;
  • 第一版可以保持私人;
  • 第一次成功不需要生产服务器;
  • 你知道这一次什么算完成。

第 2 集会创建 CLI 工作区,并验证本地内容引擎可以初始化、校验、同步和给出下一步建议。

0 次点赞
Silan Hu2 次阅读分享:
访客身份
G

还没有评论