feat(cli): extract Obelisk runtime into npm package

Add @obelisk-apps/cli with the existing build, search, query, and attune contract plus official skill installation. Separate the docs-only skill artifact, bootstrap installer, release layout, cross-platform CI, and package-level regression coverage.
2026-07-16 17:26:23 +08:00
parent 49158e9b9c
commit 90191e4604
64 changed files with 1112 additions and 745 deletions
@@ -0,0 +1,68 @@
+# Card 4 Workflow Writing
+
+Workflow is the orchestration card. It should show the strongest few workflow
+runs and the user's reaction to them. Before writing, remove any row whose
+reaction is not traceable to a visible user reaction.
+
+## Mock taste anchor
+
+```json
+{
+  "type": "workflow",
+  "title": "Three workflows. Forty-two agents.",
+  "deck": "你召唤了机器军团。结果各有不同。",
+  "stats": "3 workflows · 42 agents",
+  "items": [
+    { "name": "hono-plugin-review", "reaction": "完美" },
+    { "name": "vue-migration", "reaction": "你这页面完全和之前的不一样…" },
+    { "name": "split-render-js", "reaction": "可以" }
+  ],
+  "verdict": "Mostly tolerated."
+}
+```
+
+The row reactions are user reactions. The title carries the metric; the verdict
+is a small English seal.
+
+## JSON Shape
+
+```ts
+type WorkflowCard = {
+  type: "workflow";
+  title: string;
+  deck?: string;
+  stats?: string;
+  items: Array<{
+    name: string;
+    reaction: string;
+    evidence_refs?: string[];
+  }>;
+  verdict: string;
+};
+```
+
+Field duties:
+
+- `title`: human story line or compact metric line.
+- `deck`: optional second line; do not repeat stats mechanically.
+- `stats`: compact count line.
+- `items[].name`: actual workflow name, command name, or run-id prefix.
+- `items[].reaction`: exact or lightly trimmed user reaction. Preserve source
+  language. No feature description, implementation summary, agent count,
+  duration, "framework switch", "modularization", "theming landed", or other
+  internal progress label.
+- `verdict`: compact seal based on the row reactions, often 3-6 words.
+
+Agent counts belong only in `title` or `stats`, never in `items[].reaction`.
+These row values are invalid because they are implementation labels, not user
+reactions:
+
+- `13 agents, the big build` is invalid.
+- `9 agents, framework switch` is invalid.
+- `6 agents, modularization` is invalid.
+- `theming landed` is invalid.
+
+If no user reaction exists, omit the row rather than write an implementation result.
+After writing, check that every row name maps to retrieval evidence and every
+reaction can be read as quoted user verdict text.
+Update the JSON now before reading `pattern5-closing.md`.