yushanhe
f097f5bc21
designops-gateway / build (push) Failing after 20m0s
- merge openpencil/penpot/excalidraw/style-dictionary/storybook as native monorepo code (upstream .git removed; origins in okf/manifest.md) - add project-level okf/ (manifest + memory/rule/skill/decision/lesson) - add AGENTS.md (OKF annotation standard) + monorepo .gitignore - annotate 9 entry files with @module/@skill/@rule headers - add GitOps deploy bundle (infra/gitops/) + Gitea CI (.gitea/workflows/)
1.4 KiB
1.4 KiB
DesignOps 项目级 OKF（Open Knowledge Framework）
本目录是 DesignOps 中台的项目级知识库，按 OKF 标准组织。与全局 OKF（~/.dsh/okf）隔离——项目级节点不可由 okf_* 工具读取，须按路径读（见全局 Rule 项目级-okf-不可由-okf-工具读取-必须按路径读）。
目录结构
| 子目录 | 用途 | 节点类型 |
|---|---|---|
manifest.md |
子项目登记（来源/license/入口） | Manifest |
memory/ |
项目记忆（架构事实、实测记录） | Memory |
rule/ |
项目规则（注释标准、部署不变式） | Rule |
skill/ |
项目技能（能力注册） | Skill |
decision/ |
项目决策（ADR） | Decision |
lesson/ |
项目教训（运维坑） | Lesson |
注释即文档（Annotation-as-Documentation）
DesignOps 代码遵循 okf-annotation-engineering 二步工作流：Step1 注释先行（@tag + DocGate 三问）→ Step2 代码跟随。
- 模块级注释：每个源文件头部一个
@module块（@module/@zone/@tier+@skill≥1 +@rule≥1） - 排除范围：纯配置(.json/.yaml)、纯文档(README)、数据文件、DSH 运行时数据
- 详细格式见
AGENTS.md与全局模板~/.dsh/skills/okf-annotation-templates/
关联资产
- 全局技能：
k3s-gitea-gitops、gitea、okf-annotation-engineering - 全局 OKF 子目录：
k3s-gitea-gitops/（可持续迭代部署四节点）