依据 #34 对齐 SPIRE 阶段状态并明确状态查询前的沟通规则

This commit is contained in:
2026-09-16 14:48:02 +00:00
parent 5aa50d71ad
commit c6386a1101
7 changed files with 113 additions and 8 deletions
+11 -1
View File
@@ -1,5 +1,15 @@
# 文档维护规则
## 查询前先对齐
查询项目状态前,先询问维护者正在进行的工作、跟踪 ticket 和尚未成文的现状。
已有明确授权则在该范围内继续,不重复询问;文档查询授权不自动扩展为现场检查。
2026-09-16 维护者指定 SPIFFE/SPIRE 基本以 homelab-infra #34 的记录为依据;
本轮仅查该 ticket 及其直接引用的 runbook,没有查询现场。其他项目仍需先询问。
稳定设计与使用方法放知识库,动态进度链接到 ticket。知识库只保留注明查阅日期的阶段摘要,
不复制维护第二份实时任务列表。issue open 可能表示后续阶段未完成,不能据此推断基础服务未部署。
## 状态与证据
分别记录服务生命周期和验证程度,避免一个“完成”掩盖多个状态:
@@ -16,7 +26,7 @@ accepted 不代表部署完成,implemented 必须附实现和验收依据。
## 一项工作的完成条件
1. 修改前读取服务文档及相关约束,检查已知冲突。
1. 先按上述规则对齐查询范围,再读取服务文档、相关 ticket 和约束,区分动态工作与事实冲突。
2. 实施和必要验证后,同步用途、入口、使用方法、依赖和恢复步骤中的变化。
3. 新增或退役服务时更新服务总览;退役文档保留替代入口和原因。
4. 代码与文档分属仓库时互相链接 commit/PR;未部署或未同步的部分明确写出。