depa-codument 0.4.1

package/src/templates/codument/std/spec/xnl-format.md

@@ -0,0 +1,301 @@
+> **Provenance（vendored 注记）**
+> - 来源：xnl-core `doc/ai-guide/XnlDataFormatForAi.md`
+> - 版本：xnl-core 0.1.7
+> - vendored 日期：2026-06-21
+> - 原因：npm 包只发布 `dist/`，`doc/` 不在包内，故 vendor 一份作为 codument 的 XNL 语法权威。
+
+# XNL 数据格式（大模型版）
+XNL（Extensible Notation Language）
+用于提示大语言模型理解与生成新版短标签的 XNL（Extensible Notation Language）。语法沿用 XML 风格起始标签，但闭合极简，便于对话/提示场景快速书写。
+
+## 核心语法速览
+- 开始标签：`<name metadata... sections...>`。
+- 元数据：`key=value` 紧跟在标签名后，可有多个。
+- 属性块：`{ key = value ... }` → 存入 `attributes`。
+- 数组块：`[ item1 item2 <child> ]` → 存入 `body`（元素可为值或子节点）。
+- 唯一子节点块（extend）：`( <child1> <child2> )` → 存入 `extend`，同名覆盖旧值并警告，保持出现顺序。
+- 文本块：`<name metadata {attr} ?marker> ... </?marker>`，允许 metadata/`{}`，禁止 `[]`/`()`；标记可选但必须首尾一致。
+- 无其它块时直接以 `>` 结束节点。
+
+## 字面量与节点
+- `ValueLiteral` 仅包含：字符串（单双引号，支持 `\\`、`\"`、`\'`、`\n`、`\t`、`\r`）、布尔、null、数值（保留整数/浮点种类）。
+- 对象值：`{ key = value ... }`，键可为标识符或引号字符串；`value` 可以是任意 `XnlNode`（值、对象、数组、元素、注释）。
+- 数组值：`[ ... ]`，元素是 `XnlNode`，因此数组/对象/属性可嵌入完整的子标签结构或值。
+- `metadata`/`attributes`/`body` 同样以 `Record<string, XnlNode>` 或 `XnlNode[]` 表示，可混合值与子元素。
+- 无表达式 `(expr)` 或原始 `<(raw)>` 语义；括号仅用于 extend 块。
+
+## 结构与约束
+- 文本块不能与 `[]` 或 `()` 同时出现；可带 metadata 与 `{}`。
+- extend 块必须全是子节点；同名覆盖旧值并产生 `DUPLICATE_CHILD` 警告。
+- 对象/数组/属性值可混合值与标签；当需要唯一子节点语义仍应使用 `()`。
+- 注释 `<!-- ... -->` 可出现在节点间、块内、文本块中；解析时跳过（文本块会移除注释内容）。
+- 多行文本去缩进：去掉首行空行，然后按结束 `</#...>` 行左侧缩进去除前缀（空格/Tab）。
+
+## EBNF 摘要
+```ebnf
+Document    = S? Node* ;
+Node        = TextNode | Element | VoidNode ;
+Element     = "<" Name Metadata? Sections ">" ;
+VoidNode    = "<" Name Metadata? ">" ;
+TextNode    = "<" Name Metadata? AttributeBlock? "?" TextMarker? ">" TextContent "</?" TextMarker? ">" ;
+
+Metadata    = (S Attribute)* ;
+Attribute   = Key S? "=" S? ValueLiteral ;
+Key         = Name | String ;
+
+Sections    = (AttributeBlock | ArrayBlock | ExtendBlock)+ ;
+AttributeBlock = "{" MapEntries "}" ;
+ArrayBlock  = "[" ArrayItems "]" ;
+ExtendBlock = "(" ExtendChildren ")" ;
+
+MapEntries  = (S? MapEntry S?)* ;
+MapEntry    = Key S? "=" S? ValueLiteral ;
+ArrayItems  = (S? (ValueLiteral | Node) S?)* ;
+ExtendChildren = (S? Node S?)* ; (* child tag names unique; later wins with warning *)
+
+ValueLiteral = Literal | ObjectLiteral | ArrayLiteral ;
+ObjectLiteral = "{" (S? MapEntry (S MapEntry)*)? S? "}" ;
+ArrayLiteral  = "[" (S? ValueLiteral (S ValueLiteral)*)? S? "]" ;
+
+Literal     = Boolean | Null | Number | String | IdentifierString ;
+Boolean     = "true" | "false" ;
+Null        = "null" ;
+Number      = Integer | Float ;
+String      = DoubleString | SingleString ;
+IdentifierString = IdentifierStart IdentifierChar* ;
+TextMarker  = IdentifierString ;
+```
+
+## 类型定义
+```typescript
+export type NumericKind = "Integer" | "Float";
+
+export interface StringValue {
+  kind: "String";
+  value: string;
+}
+
+export interface BooleanValue {
+  kind: "Boolean";
+  value: boolean;
+}
+
+export interface NullValue {
+  kind: "Null";
+}
+
+export interface NumberValue {
+  kind: "Number";
+  value: number;
+  numericKind: NumericKind;
+  raw: string;
+}
+
+export type ValueLiteral = StringValue | BooleanValue | NullValue | NumberValue;
+
+export interface ObjectValue {
+  kind: "Object";
+  entries: Record<string, XnlNode>;
+}
+
+export interface ArrayValue {
+  kind: "Array";
+  items: XnlNode[];
+}
+
+export type AttributeMap = Record<string, XnlNode>;
+
+export interface ExtendBody {
+  order: string[];
+  children: Record<string, ElementNode>;
+}
+
+export interface ElementNode {
+  name: string;
+  metadata: AttributeMap;
+  attributes?: AttributeMap;
+  body?: XnlNode[];
+  extend?: ExtendBody;
+  text?: string;
+  textMarker?: string;
+}
+
+export interface CommentNode {
+  type: "Comment";
+  value: string;
+}
+
+export type ContainerNode = ArrayValue | ObjectValue | ElementNode;
+
+export type XnlNode = ValueLiteral | ContainerNode | CommentNode;
+
+```
+
+## 示例
+```xnl
+<doc [
+  <no_body_node1>
+  <no_body_node2 a=[1] b={c=3}>
+  <metadata_demo1 xx=1 {
+    a = 'abc'
+    b = "tt\t\n"
+    c = { inner = 2 }
+    "string as key" = 2.3
+    'string as key2' = 3.4
+  }>
+  <list_body1 [
+    1 2 <item id="x" count=3 active=true note="hi">
+  ]>
+  <has_extend1 (
+    <a {v=1}>
+    <a {v=2}> <!-- 覆盖前一个 a，产生 DUPLICATE_CHILD 警告 -->
+  )>
+  <has_extend2 (
+    <abc {
+      a = [1 2]
+      b = {c = 3}
+    }>
+    <efg [
+      1
+      <b>
+    ]>
+  )>
+  <mixed_1 {
+    a = 1
+  } [
+    1
+    [2 3]
+    <tt>
+  ] (
+    <abc {
+      a = [1 2]
+      b = {c = 3}
+    }>
+    <efg [
+      1
+      <b>
+    ]>
+  )>
+  <text1 a=1 {b="zh"} ?>
+    在纯文本内部，无需转义，例如 & < > #
+    可以包含形如 <notatag 的内容，均按文本处理
+    多行文本会按结束标签所在行的缩进去除前缀
+  </?>
+  <text2 a=1 {b="cc"} ?flag_1234>
+    如果文本中包含 `</?>` 字样，可在开始标签后加标记，如 `?flag_1234`
+    结束标签必须使用相同标记 `?flag_1234`
+  </?flag_1234>
+]>
+```
+
+## 生成检查清单
+- 文本块用 `<name ... ?marker?> ... </?marker?>`，不与 `[]`/`()` 同用；metadata 与 `{}` 可放在 `?` 前。
+- extend 块只写子节点，同名覆盖并警告；需要多个同名请改用数组块。
+- 键名若含空格/特殊字符请加引号；字符串可用单/双引号。
+- 注释可写，但会被忽略；文本内注释也会被移除。
+
+
+## ❌ 常见错误示例
+
+**闭合标签类型不匹配**是最容易犯的错误！开始标签的类型必须与结束标签的类型严格对应
+**使用了xml的闭合标签规则**是其次最容易犯的错误！虽然看起来类似，但是实际内部结构和xml有极大的不同
+
+### 闭合标签不匹配
+#### ❌ 错误示例
+
+```xnl
+<SetVariable id="SetVariable-a" {
+  name="SetVariable"
+  assignTo = "sum"
+]>  ❌ 错误！`{` 对应 `}`，不是 `]`
+```
+
+#### ✅ 正确示例
+
+```xnl
+<SetVariable id="SetVariable-a" {
+  name="SetVariable"
+  assignTo = "sum"
+}>  ✅ 正确！ `{` 对应 `}`
+```
+
+### 文本节点使用了xml的结束标签规则
+#### ❌ 错误示例1
+
+```xnl
+<div id="" ?>
+</div> ❌ 错误！文本标签的结束，如果没有自定义marker，应当用`</?>`，不是 `</div>`
+```
+
+#### ❌ 错误示例2
+
+```xnl
+<div id="" ?>
+</?>
+</div> ❌ 错误! 前面已经通过</?>，闭合了标签，不能再添加类似xml的结束标签
+```
+
+#### ✅ 正确示例
+
+```xnl
+<div id="" ?>
+</?>
+```
+
+
+### 文本节点自定义的marker不匹配
+#### ❌ 错误示例
+
+```xnl
+<my_text id="" ?ttt>
+  content
+</?qqq> 
+❌ 错误！文本标签的结束，如果有marker，应当与开始节点一致`</?ttt>`，不能是其他marker，例如本例中错误的 `</?qqq>`
+```
+
+#### ✅ 正确示例
+
+```xnl
+<my_text id="" ?ttt>
+  content
+</?ttt> 
+```
+
+
+### 元素标签名含冒号
+XNL 元素标签名**禁含冒号**。命名空间 / 领域前缀（如 codument modeling 的 shell kind `backend:endpoint`、`surface:route`）应放进 `kind` **属性**表达，**不要写进标签名**——标签名写冒号会触发 XNL 语法错（如 `Expected metadata key`）。
+
+#### ❌ 错误示例
+
+```xnl
+<backend:endpoint id="place_order" kind="backend:endpoint"> ❌ 错误！标签名 `backend:endpoint` 含冒号 → 语法错（解析器在冒号处期望 metadata key）
+```
+
+#### ✅ 正确示例
+
+```xnl
+<endpoint id="place_order" kind="backend:endpoint"> ✅ 正确！标签名是普通词 `endpoint`，命名空间 kind 放进 `kind` 属性
+```
+
+
+### component 四块未用裸标签
+（codument modeling 约定）`component` 节点的 runtime / input / config / output 四块**用裸标签** `<runtime>` / `<input>` / `<config>` / `<output>`（canonical / 推荐）。`<types role="runtime">` 这类 role 写法 `validate` 也兼容接受，但**裸标签为推荐形式**。
+
+#### ❌ 不推荐（accepted-but-discouraged）
+
+```xnl
+<component id="place_order_proc" kind="component" [
+  <types role="runtime" ?r>type Runtime = { clock: Clock }</?r>
+]>
+```
+
+#### ✅ 推荐（canonical）
+
+```xnl
+<component id="place_order_proc" kind="component" [
+  <runtime ?r>type Runtime = { clock: Clock }</?r>
+  <input ?i>interface Input { cartId: string }</?i>
+  <config ?c>interface Config { maxLines: number }</?c>
+  <output ?o>interface Output { orderId: string }</?o>
+]>
+```

package/src/templates/codument/workflows/README.md

@@ -0,0 +1,15 @@
+# codument/workflows/ —— dynamic-workflow 流程的存放目录
+
+本目录用于存放结构化 workflow 的 definitions 与 instances，布局与通用 workflow 规范保持一致：
+
+```
+workflows/
+├── definitions/    预制可复用单元（AgentTaskDefinition / 类型包），与 dynamic-workflow 同格式
+└── instances/      BTWorkflow 流程实例（process-instance.xml 等）
+```
+
+- 这里放的是**结构化、可被引擎执行的流程定义/实例**（`BTWorkflow` + `<Imports>`/`<Ports>`/`<Hook>`/`<TaskSpace>`/`<Extension>`），复用同一内核。
+- 与 codument 自身：codument track（`track.xml`）的 `<TaskSpace>` 与这里 BTWorkflow 的 task-space **同构**，可互相引用/嵌入；codument 的 `cdt:` check 是内置节点类型（配置在节点上），dynamic-workflow 侧也可用同名 kind。
+- **业务自定义的执行流程（文字/SOP 型）不放这里**——放 `codument/std/sop/`（见 `../sop/README.md`）。
+
+> 具体 definitions/instances 按项目需要补充。

package/src/templates/manifest.ts

@@ -0,0 +1,177 @@
+// AUTO-GENERATED by scripts/gen-template-manifest.ts — do not edit by hand.
+// Regenerate after changing anything under src/templates/:
+//   bun run scripts/gen-template-manifest.ts
+
+import f0 from './codument/README.md' with { type: 'text' };
+import f1 from './codument/attractors/product.md' with { type: 'text' };
+import f2 from './codument/attractors/project.md' with { type: 'text' };
+import f3 from './codument/backlog/README.md' with { type: 'text' };
+import f4 from './codument/config/attractor-profiles.xml' with { type: 'text' };
+import f5 from './codument/config/engineering.xml' with { type: 'text' };
+import f6 from './codument/config/modeling.xml' with { type: 'text' };
+import f7 from './codument/config/operation-hooks.xml' with { type: 'text' };
+import f8 from './codument/memory/README.md' with { type: 'text' };
+import f9 from './codument/missions/README.md' with { type: 'text' };
+import f10 from './codument/sop/README.md' with { type: 'text' };
+import f11 from './codument/std/AGENTS.md' with { type: 'text' };
+import f12 from './codument/std/attractors/depa-attractor.md' with { type: 'text' };
+import f13 from './codument/std/attractors/knowledge-tiers.md' with { type: 'text' };
+import f14 from './codument/std/attractors/model-driven-docs.md' with { type: 'text' };
+import f15 from './codument/std/attractors/project-memory.md' with { type: 'text' };
+import f16 from './codument/std/docs-impl-fractal/index.md' with { type: 'text' };
+import f17 from './codument/std/docs-modeling-fractal/index.md' with { type: 'text' };
+import f18 from './codument/std/kernel-pointer.md' with { type: 'text' };
+import f19 from './codument/std/operations/README.md' with { type: 'text' };
+import f20 from './codument/std/operations/_operation-spec.md' with { type: 'text' };
+import f21 from './codument/std/operations/archive-mission.md' with { type: 'text' };
+import f22 from './codument/std/operations/archive-track.md' with { type: 'text' };
+import f23 from './codument/std/operations/artifact-sync.md' with { type: 'text' };
+import f24 from './codument/std/operations/discuss-phase.md' with { type: 'text' };
+import f25 from './codument/std/operations/discuss.md' with { type: 'text' };
+import f26 from './codument/std/operations/docs-bootstrap.md' with { type: 'text' };
+import f27 from './codument/std/operations/gap-loop.md' with { type: 'text' };
+import f28 from './codument/std/operations/impl-mission.md' with { type: 'text' };
+import f29 from './codument/std/operations/impl-quick.md' with { type: 'text' };
+import f30 from './codument/std/operations/impl-track.md' with { type: 'text' };
+import f31 from './codument/std/operations/migrate.md' with { type: 'text' };
+import f32 from './codument/std/operations/plan-mission.md' with { type: 'text' };
+import f33 from './codument/std/operations/plan-track-wave.md' with { type: 'text' };
+import f34 from './codument/std/operations/plan-track.md' with { type: 'text' };
+import f35 from './codument/std/operations/revise-track.md' with { type: 'text' };
+import f36 from './codument/std/operations/validate.md' with { type: 'text' };
+import f37 from './codument/std/operations/verify.md' with { type: 'text' };
+import f38 from './codument/std/root-agents.md' with { type: 'text' };
+import f39 from './codument/std/sop/questioning.md' with { type: 'text' };
+import f40 from './codument/std/sop/tdd.md' with { type: 'text' };
+import f41 from './codument/std/sop/validation.md' with { type: 'text' };
+import f42 from './codument/std/sop/wave-exec.md' with { type: 'text' };
+import f43 from './codument/std/sop/workflow.md' with { type: 'text' };
+import f44 from './codument/std/spec/behavior-delta.md' with { type: 'text' };
+import f45 from './codument/std/spec/behavior-registry.md' with { type: 'text' };
+import f46 from './codument/std/spec/engineering-delta.md' with { type: 'text' };
+import f47 from './codument/std/spec/engineering-node-schema.md' with { type: 'text' };
+import f48 from './codument/std/spec/engineering-registry.md' with { type: 'text' };
+import f49 from './codument/std/spec/flow-notation.md' with { type: 'text' };
+import f50 from './codument/std/spec/folder-manifest.md' with { type: 'text' };
+import f51 from './codument/std/spec/mission-xml-spec.md' with { type: 'text' };
+import f52 from './codument/std/spec/modeling-delta.md' with { type: 'text' };
+import f53 from './codument/std/spec/modeling-node-schema.md' with { type: 'text' };
+import f54 from './codument/std/spec/modeling-registry.md' with { type: 'text' };
+import f55 from './codument/std/spec/track-xml-spec.md' with { type: 'text' };
+import f56 from './codument/std/spec/xnl-format.md' with { type: 'text' };
+import f57 from './codument/workflows/README.md' with { type: 'text' };
+import f58 from './skills/README.md' with { type: 'text' };
+import f59 from './skills/codument-archive-mission/SKILL.md' with { type: 'text' };
+import f60 from './skills/codument-archive-track/SKILL.md' with { type: 'text' };
+import f61 from './skills/codument-archive/SKILL.md' with { type: 'text' };
+import f62 from './skills/codument-artifact-sync/SKILL.md' with { type: 'text' };
+import f63 from './skills/codument-code-quality-score/SKILL.md' with { type: 'text' };
+import f64 from './skills/codument-decision-tree/SKILL.md' with { type: 'text' };
+import f65 from './skills/codument-discuss-phase/SKILL.md' with { type: 'text' };
+import f66 from './skills/codument-discuss/SKILL.md' with { type: 'text' };
+import f67 from './skills/codument-docs-bootstrap/SKILL.md' with { type: 'text' };
+import f68 from './skills/codument-gap-loop/SKILL.md' with { type: 'text' };
+import f69 from './skills/codument-impl-mission/SKILL.md' with { type: 'text' };
+import f70 from './skills/codument-impl-quick/SKILL.md' with { type: 'text' };
+import f71 from './skills/codument-impl-track/SKILL.md' with { type: 'text' };
+import f72 from './skills/codument-implement/SKILL.md' with { type: 'text' };
+import f73 from './skills/codument-migrate/SKILL.md' with { type: 'text' };
+import f74 from './skills/codument-modeling-engineering-e2e/SKILL.md' with { type: 'text' };
+import f75 from './skills/codument-plan-mission/SKILL.md' with { type: 'text' };
+import f76 from './skills/codument-plan-track-wave/SKILL.md' with { type: 'text' };
+import f77 from './skills/codument-plan-track/SKILL.md' with { type: 'text' };
+import f78 from './skills/codument-revise-track/SKILL.md' with { type: 'text' };
+import f79 from './skills/codument-track/SKILL.md' with { type: 'text' };
+import f80 from './skills/codument-validate/SKILL.md' with { type: 'text' };
+import f81 from './skills/codument-verify/SKILL.md' with { type: 'text' };
+
+export interface TemplateFile {
+  /** Path relative to src/templates/, e.g. "codument/std/AGENTS.md" or "skills/codument-track/SKILL.md". */
+  path: string;
+  content: string;
+}
+
+export const TEMPLATE_FILES: TemplateFile[] = [
+  { path: "codument/README.md", content: f0 },
+  { path: "codument/attractors/product.md", content: f1 },
+  { path: "codument/attractors/project.md", content: f2 },
+  { path: "codument/backlog/README.md", content: f3 },
+  { path: "codument/config/attractor-profiles.xml", content: f4 },
+  { path: "codument/config/engineering.xml", content: f5 },
+  { path: "codument/config/modeling.xml", content: f6 },
+  { path: "codument/config/operation-hooks.xml", content: f7 },
+  { path: "codument/memory/README.md", content: f8 },
+  { path: "codument/missions/README.md", content: f9 },
+  { path: "codument/sop/README.md", content: f10 },
+  { path: "codument/std/AGENTS.md", content: f11 },
+  { path: "codument/std/attractors/depa-attractor.md", content: f12 },
+  { path: "codument/std/attractors/knowledge-tiers.md", content: f13 },
+  { path: "codument/std/attractors/model-driven-docs.md", content: f14 },
+  { path: "codument/std/attractors/project-memory.md", content: f15 },
+  { path: "codument/std/docs-impl-fractal/index.md", content: f16 },
+  { path: "codument/std/docs-modeling-fractal/index.md", content: f17 },
+  { path: "codument/std/kernel-pointer.md", content: f18 },
+  { path: "codument/std/operations/README.md", content: f19 },
+  { path: "codument/std/operations/_operation-spec.md", content: f20 },
+  { path: "codument/std/operations/archive-mission.md", content: f21 },
+  { path: "codument/std/operations/archive-track.md", content: f22 },
+  { path: "codument/std/operations/artifact-sync.md", content: f23 },
+  { path: "codument/std/operations/discuss-phase.md", content: f24 },
+  { path: "codument/std/operations/discuss.md", content: f25 },
+  { path: "codument/std/operations/docs-bootstrap.md", content: f26 },
+  { path: "codument/std/operations/gap-loop.md", content: f27 },
+  { path: "codument/std/operations/impl-mission.md", content: f28 },
+  { path: "codument/std/operations/impl-quick.md", content: f29 },
+  { path: "codument/std/operations/impl-track.md", content: f30 },
+  { path: "codument/std/operations/migrate.md", content: f31 },
+  { path: "codument/std/operations/plan-mission.md", content: f32 },
+  { path: "codument/std/operations/plan-track-wave.md", content: f33 },
+  { path: "codument/std/operations/plan-track.md", content: f34 },
+  { path: "codument/std/operations/revise-track.md", content: f35 },
+  { path: "codument/std/operations/validate.md", content: f36 },
+  { path: "codument/std/operations/verify.md", content: f37 },
+  { path: "codument/std/root-agents.md", content: f38 },
+  { path: "codument/std/sop/questioning.md", content: f39 },
+  { path: "codument/std/sop/tdd.md", content: f40 },
+  { path: "codument/std/sop/validation.md", content: f41 },
+  { path: "codument/std/sop/wave-exec.md", content: f42 },
+  { path: "codument/std/sop/workflow.md", content: f43 },
+  { path: "codument/std/spec/behavior-delta.md", content: f44 },
+  { path: "codument/std/spec/behavior-registry.md", content: f45 },
+  { path: "codument/std/spec/engineering-delta.md", content: f46 },
+  { path: "codument/std/spec/engineering-node-schema.md", content: f47 },
+  { path: "codument/std/spec/engineering-registry.md", content: f48 },
+  { path: "codument/std/spec/flow-notation.md", content: f49 },
+  { path: "codument/std/spec/folder-manifest.md", content: f50 },
+  { path: "codument/std/spec/mission-xml-spec.md", content: f51 },
+  { path: "codument/std/spec/modeling-delta.md", content: f52 },
+  { path: "codument/std/spec/modeling-node-schema.md", content: f53 },
+  { path: "codument/std/spec/modeling-registry.md", content: f54 },
+  { path: "codument/std/spec/track-xml-spec.md", content: f55 },
+  { path: "codument/std/spec/xnl-format.md", content: f56 },
+  { path: "codument/workflows/README.md", content: f57 },
+  { path: "skills/README.md", content: f58 },
+  { path: "skills/codument-archive-mission/SKILL.md", content: f59 },
+  { path: "skills/codument-archive-track/SKILL.md", content: f60 },
+  { path: "skills/codument-archive/SKILL.md", content: f61 },
+  { path: "skills/codument-artifact-sync/SKILL.md", content: f62 },
+  { path: "skills/codument-code-quality-score/SKILL.md", content: f63 },
+  { path: "skills/codument-decision-tree/SKILL.md", content: f64 },
+  { path: "skills/codument-discuss-phase/SKILL.md", content: f65 },
+  { path: "skills/codument-discuss/SKILL.md", content: f66 },
+  { path: "skills/codument-docs-bootstrap/SKILL.md", content: f67 },
+  { path: "skills/codument-gap-loop/SKILL.md", content: f68 },
+  { path: "skills/codument-impl-mission/SKILL.md", content: f69 },
+  { path: "skills/codument-impl-quick/SKILL.md", content: f70 },
+  { path: "skills/codument-impl-track/SKILL.md", content: f71 },
+  { path: "skills/codument-implement/SKILL.md", content: f72 },
+  { path: "skills/codument-migrate/SKILL.md", content: f73 },
+  { path: "skills/codument-modeling-engineering-e2e/SKILL.md", content: f74 },
+  { path: "skills/codument-plan-mission/SKILL.md", content: f75 },
+  { path: "skills/codument-plan-track-wave/SKILL.md", content: f76 },
+  { path: "skills/codument-plan-track/SKILL.md", content: f77 },
+  { path: "skills/codument-revise-track/SKILL.md", content: f78 },
+  { path: "skills/codument-track/SKILL.md", content: f79 },
+  { path: "skills/codument-validate/SKILL.md", content: f80 },
+  { path: "skills/codument-verify/SKILL.md", content: f81 },
+];

package/src/templates/skills/README.md

@@ -0,0 +1,38 @@
+# Codument agent skill 壳
+
+本目录是 **coding-agent 标准的 skill 壳**集合：每个操作一个目录，内含一份 `SKILL.md`（frontmatter `name`+`description` + 薄壳正文）。**codument 安装时把这些壳复制进对应 coding agent 的 skill 安装目录**（如 `.claude/skills/`）。
+
+壳是**薄壳**：它只声明"何时用"（description 供 agent 路由）+ 指向工作区里**权威的操作 body**——`@/codument/std/operations/<op>.md`，由 agent 打开并遵循。真正的提示词内容、规则、流程都在 `@/codument/std/operations/`（不在壳里），从而：
+
+- 壳随 agent 安装目录走、轻量、可被多种 agent 复用；
+- body 随项目工作区（`@/codument/`）走、自包含、可被 `upgrade-workspace` 刷新；
+- 不重复、不双源——壳变更频率低，body 是唯一真源。
+
+## 壳 → body 映射
+
+| skill 壳目录 | 指向的 body |
+|---|---|
+| `codument-impl-quick/` | `@/codument/std/operations/impl-quick.md` |
+| `codument-discuss/` | `@/codument/std/operations/discuss.md` |
+| `codument-plan-track/` | `@/codument/std/operations/plan-track.md` |
+| `codument-discuss-phase/` | `@/codument/std/operations/discuss-phase.md` |
+| `codument-plan-track-wave/` | `@/codument/std/operations/plan-track-wave.md` |
+| `codument-impl-track/` | `@/codument/std/operations/impl-track.md` |
+| `codument-gap-loop/` | `@/codument/std/operations/gap-loop.md` |
+| `codument-verify/` | `@/codument/std/operations/verify.md` |
+| `codument-revise-track/` | `@/codument/std/operations/revise-track.md` |
+| `codument-validate/` | `@/codument/std/operations/validate.md` |
+| `codument-archive-track/` | `@/codument/std/operations/archive-track.md` |
+| `codument-plan-mission/` | `@/codument/std/operations/plan-mission.md` |
+| `codument-impl-mission/` | `@/codument/std/operations/impl-mission.md` |
+| `codument-archive-mission/` | `@/codument/std/operations/archive-mission.md` |
+| `codument-artifact-sync/` | `@/codument/std/operations/artifact-sync.md` |
+| `codument-docs-bootstrap/` | `@/codument/std/operations/docs-bootstrap.md` |
+| `codument-migrate/` | `@/codument/std/operations/migrate.md` |
+| `codument-decision-tree/` | 直接遵循 `@/codument/std/sop/questioning.md`，生成 decision-tree 并回写 decisions |
+| `codument-modeling-engineering-e2e/` | 直接运行 `scripts/verify-modeling-engineering-e2e.sh` 的真实 E2E 操作 skill |
+| `codument-code-quality-score/` | 直接运行 `scripts/score-e2e-code-quality.ts` 并做证据化代码质量评价的 skill |
+
+CLI 辅助命令 `codument init` / `codument status` 不再提供 agent skill 壳；它们作为普通 CLI 命令使用。
+
+> `SKILL.md` 采用 Agent Skills 标准：`name`（=目录名，小写连字符）+ `description`（agent 据此决定何时调用）+ 薄壳正文。其它 agent 专属命令格式（codex/opencode/…）由 codument 生成器按 agent 类型从同一 body 派生。

package/src/templates/skills/codument-archive/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: codument-archive
+description: [已更名为 codument-archive-track] 归档已完成 track——提升 behavior 进 behaviors/、移入 archive/、按开关条件提升 decision/memory、按显式 hook 同步 docs/制品、校验。track 完成并部署后收口时使用。
+---
+
+# Codument · archive
+
+这是 codument **archive** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**：
+
+`@/codument/std/operations/archive-track.md`
+
+按其中的 Markdown 说明 + `--` 流程标记块执行（带条件 gate 的提升流水线）；behavior 提升格式见 `@/codument/std/spec/behavior-registry.md`，晋升判定权威见 `@/codument/std/attractors/knowledge-tiers.md` §4–§5（均由 body 引用）。
+
+- **前置**：项目已通过 `codument init` 初始化，目标 track 已完成。
+- **用法**：归档 track: `<track-id>`。
+
+> 壳只做路由，不重述规则。一切以 `@/codument/std/operations/archive-track.md` 为准。

package/src/templates/skills/codument-archive-mission/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: codument-archive-mission
+description: 归档 mission——把 completed/cancelled/superseded mission 移入 codument/missions/archived/YYYY-MM-DD-<mission-id>/，并按配置提升 durable decisions/memory。mission 收口时使用。
+---
+
+# Codument · archive-mission
+
+这是 codument **archive-mission** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**：
+
+`@/codument/std/operations/archive-mission.md`
+
+mission.xml 规范见 `@/codument/std/spec/mission-xml-spec.md`；归档晋升判定见 `@/codument/std/attractors/knowledge-tiers.md`。
+
+- **前置**：项目已通过 `codument init` 初始化，目标 mission 已完成、取消、废弃或被替代。
+- **用法**：归档 mission: `<mission-id>`。
+
+> 壳只做路由，不重述规则。一切以 `@/codument/std/operations/archive-mission.md` 为准。

package/src/templates/skills/codument-archive-track/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: codument-archive-track
+description: 归档已完成 track——提升 behavior 进 behaviors/、移入 archive/、按开关条件提升 decision/memory、按显式 hook 同步 docs/制品、校验。track 完成并部署后收口时使用。
+---
+
+# Codument · archive-track
+
+这是 codument **archive** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**：
+
+`@/codument/std/operations/archive-track.md`
+
+按其中的 Markdown 说明 + `--` 流程标记块执行（带条件 gate 的提升流水线）；behavior 提升格式见 `@/codument/std/spec/behavior-registry.md`，晋升判定权威见 `@/codument/std/attractors/knowledge-tiers.md` §4–§5（均由 body 引用）。
+
+- **前置**：项目已通过 `codument init` 初始化，目标 track 已完成。
+- **用法**：归档 track: `<track-id>`。
+
+> 壳只做路由，不重述规则。一切以 `@/codument/std/operations/archive-track.md` 为准。

package/src/templates/skills/codument-artifact-sync/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: codument-artifact-sync
+description: 把 track 的 output 物料（docs/制品目录）按规则同步到一个或多个目标位置（dry-run/conflict/provenance 策略）。显式 hook 触发或手动同步制品时使用；不隐式触发。
+---
+
+# Codument · artifact-sync
+
+这是 codument **artifact-sync** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**：
+
+`@/codument/std/operations/artifact-sync.md`
+
+按其中的 Markdown 说明 + `--` 流程标记块执行（解析来源=track output MaterialBundle / 目标根 → fresh 子代理生成 → 按 policy 写）；docs 路由/质量规则见 `@/codument/std/operations/artifact-sync.md` §4.5（body 引用）。
+
+- **前置**：项目已通过 `codument init` 初始化，对应 profile（如 `docs`）已 enabled，且 hook 显式配置或用户手动调用。
+- **用法**：同步 artifact: `<artifact>` [track-id]。
+
+> 壳只做路由，不重述规则。一切以 `@/codument/std/operations/artifact-sync.md` 为准。