@deployxai/dxc 0.1.13 → 0.2.1

package/skills/dxc-content-workflow/references/catalog.json

@@ -1,137 +0,0 @@
-{
-  "schemaVersion": "1",
-  "workflowId": "dxc-article@1",
-  "orchestrator": {
-    "name": "dxc-content-workflow",
-    "status": "available",
-    "version": "0.6.0"
-  },
-  "steps": [
-    {
-      "name": "dxc-research",
-      "stage": "research",
-      "status": "available",
-      "version": "0.2.0",
-      "description": "围绕主题和用户指定来源生成结构化、可追溯的本地研究产物；热点默认覆盖外部观点光谱。",
-      "execution": "agent-cli",
-      "implementationLevel": "agent-local-tools",
-      "verificationLevel": "local-integration-tested",
-      "knownGaps": [
-        "公开网页研究仍依赖宿主 Agent 的浏览能力；DxC 只提供确定性采集原语，尚无定时热点发现 Runner。",
-        "热点研究若退化为只核验事实，必须记录用户明确跳过外部观点拆解；CLI 不判断观点内容质量。"
-      ],
-      "inputArtifacts": [],
-      "optionalInputArtifacts": [],
-      "outputArtifacts": ["research"],
-      "requiresHumanConfirmation": false
-    },
-    {
-      "name": "dxc-content-brief",
-      "stage": "brief",
-      "status": "available",
-      "version": "0.1.0",
-      "description": "把研究、目标读者和创作目标收敛为单一内容命题。",
-      "execution": "agent-cli",
-      "implementationLevel": "agent-guided",
-      "verificationLevel": "contract-tested",
-      "knownGaps": ["九字段内容质量由 Agent 生成，CLI 只验证结构和上游哈希。"],
-      "inputArtifacts": ["research"],
-      "optionalInputArtifacts": [],
-      "outputArtifacts": ["brief"],
-      "requiresHumanConfirmation": false
-    },
-    {
-      "name": "dxc-article-outline",
-      "stage": "outline",
-      "status": "available",
-      "version": "0.1.0",
-      "description": "根据 Brief、研究证据和历史内容召回生成文章结构。",
-      "execution": "agent-cli",
-      "implementationLevel": "agent-guided",
-      "verificationLevel": "contract-tested",
-      "knownGaps": ["结构选择和章节内容质量仍由 Agent 负责，CLI 不评价创作优劣。"],
-      "inputArtifacts": ["research", "brief"],
-      "optionalInputArtifacts": [],
-      "outputArtifacts": ["outline"],
-      "requiresHumanConfirmation": false
-    },
-    {
-      "name": "dxc-article-write",
-      "stage": "article",
-      "status": "available",
-      "version": "0.1.0",
-      "description": "依据已确认大纲、个人偏好和可追溯历史片段撰写正文。",
-      "execution": "agent-cli",
-      "implementationLevel": "agent-local-tools",
-      "verificationLevel": "local-integration-tested",
-      "knownGaps": ["正文质量由 Agent 负责；CLI 和渲染器验证格式、引用素材和交付边界。"],
-      "inputArtifacts": ["research", "brief", "outline"],
-      "optionalInputArtifacts": [],
-      "outputArtifacts": ["article"],
-      "requiresHumanConfirmation": true
-    },
-    {
-      "name": "dxc-title-write",
-      "stage": "titles",
-      "status": "available",
-      "version": "0.3.0",
-      "description": "围绕已确认正文生成并筛选微信公众号标题候选。",
-      "execution": "agent-cli",
-      "implementationLevel": "agent-guided",
-      "verificationLevel": "contract-tested",
-      "knownGaps": ["标题候选质量由 Agent 负责；CLI 验证最终选择、长度和正文哈希。"],
-      "inputArtifacts": ["article"],
-      "optionalInputArtifacts": ["brief"],
-      "outputArtifacts": ["titles"],
-      "requiresHumanConfirmation": true
-    },
-    {
-      "name": "dxc-visual-plan",
-      "stage": "visual-plan",
-      "status": "available",
-      "version": "0.3.0",
-      "description": "根据正文和标题生成或采集封面与正文配图，并记录可复验素材清单。",
-      "execution": "agent-cli",
-      "implementationLevel": "agent-local-tools",
-      "verificationLevel": "local-integration-tested",
-      "knownGaps": [
-        "图片生成依赖宿主 Agent 是否提供生成能力；CLI 负责真实文件、格式、体积和哈希校验。",
-        "正文配图自动内联尚未绑定精确语义锚点。"
-      ],
-      "inputArtifacts": ["article", "titles"],
-      "optionalInputArtifacts": ["outline"],
-      "outputArtifacts": ["visual-plan"],
-      "requiresHumanConfirmation": false
-    },
-    {
-      "name": "dxc-content-review",
-      "stage": "quality-review",
-      "status": "available",
-      "version": "0.3.0",
-      "description": "审校事实、引用、结构、标题、视觉素材可交付性与个人风格一致性。",
-      "execution": "agent-cli",
-      "implementationLevel": "agent-guided",
-      "verificationLevel": "contract-tested",
-      "knownGaps": ["事实语义和风格判断由 Agent 负责；CLI 验证结论、计数和输入绑定。"],
-      "inputArtifacts": ["research", "article", "titles"],
-      "optionalInputArtifacts": ["visual-plan"],
-      "outputArtifacts": ["quality-review"],
-      "requiresHumanConfirmation": false
-    },
-    {
-      "name": "dxc-wechat-publisher",
-      "stage": "delivery",
-      "status": "available",
-      "version": "0.6.0",
-      "description": "执行素材上传和权威渲染，在宿主右侧内置浏览器展示预览，确认目标公众号后创建草稿。",
-      "execution": "agent-cli-cloud",
-      "implementationLevel": "local-cloud-end-to-end",
-      "verificationLevel": "real-platform-smoke",
-      "knownGaps": ["支付权益、生产部署门禁和异常草稿人工核对流程仍需在生产环境完成专项验证。"],
-      "inputArtifacts": ["article", "titles", "visual-plan", "quality-review"],
-      "optionalInputArtifacts": [],
-      "outputArtifacts": ["delivery"],
-      "requiresHumanConfirmation": true
-    }
-  ]
-}

package/skills/dxc-content-workflow/references/stage-contract.md

@@ -1,121 +0,0 @@
-# DxC 阶段产物 contract
-
-每个内容 Skill 都遵守同一份轻量 contract。CLI checkpoint 是机器恢复真值，Markdown
-产物是用户可见真值。Agent 只写阶段特有的语义字段和正文；CLI 统一生成、更新并校验
-`dxc` 机器元数据。非空占位 Markdown 不能冒充已完成阶段。
-
-## 输入
-
-- catalog 声明的必需输入由 CLI 自动绑定，不传 `--inputs`，也不手抄路径或哈希。
-- 只有本次确实读取了可选输入时，才用 `--inputs` 补充该可选阶段；即使漏写必需阶段，CLI
-  也会自动补齐。交付阶段未显式传参时还会绑定所有已经就绪并实际用于交付的视觉和审校产物。
-- 上游哈希变化后，下游 checkpoint 会变为 `stale`。`project status` 的 `recoveryPlan` 会一次
-  返回全部有序失效阶段及每一步的 `command`；从第一项连续重新核验，不沿用旧标题、旧审校
-  或旧预览。`command` 中的 `dxc` 是逻辑入口，Agent 执行时必须替换为当前平台已经选定的固定
-  运行入口，不能调用 PATH 中的旧版 CLI。恢复命令只会进入该阶段的重新核验，不会替 Agent
-  确认旧语义产物仍然有效。
-
-## 输出
-
-输出必须写到 `dxc.project.json` 为当前阶段声明的路径。Agent 只写各 Skill 模板列出的阶段
-特有字段；可以完全省略 `dxc`。执行 `project checkpoint` 时，CLI 会原子补成：
-
-```yaml
----
-dxc:
-  contract: dxc-content-stage@1
-  workflowId: dxc-article@1
-  projectId: <dxc.project.json 中的 UUID>
-  stage: <research|brief|outline|article|titles|visual-plan|quality-review|delivery>
-  skill: <dxc-skill-name>@<version>
-  createdAt: <ISO 8601>
-  artifactStatus: <complete|awaiting-user|blocked>
-  inputs:
-    - kind: <实际输入种类>
-      path: <相对项目目录路径>
-      sha256: <64 位小写十六进制>
----
-```
-
-不要手工填写或修改这段元数据。CLI 从 catalog、项目清单、真实文件和当前时间取得 Skill、
-版本、项目 ID、ISO `Z` 时间、状态、输入路径和 SHA-256；用户确认时也由 CLI 把
-`artifactStatus` 从 `awaiting-user` 切为 `complete`。旧产物里位于根级的 `quoteSnapshots`
-会自动迁移到 `dxc.quoteSnapshots`。标题的正文哈希、视觉素材哈希、交付幂等键和可解析时间
-同样由 CLI 从真实产物或云端响应规范化，不由 Agent 计算。
-正文、来源、候选和报告放在 frontmatter 之后，保持 Markdown 可直接阅读和编辑。
-checkpoint 成功结果的 `artifactMutations` 列出 CLI 实际改写的相对路径及前后哈希；非空时，
-Agent 后续编辑前必须重新读取对应文件。严格校验或确认失败时，CLI 回滚该次规范化。
-
-阶段特有字段由各 Skill 的输出模板定义。视觉阶段还会校验真实 PNG/JPEG、素材目录、
-体积和 SHA-256。每个正文都必须有独立金句交接 sidecar（旁车文件）；CLI 会在缺失时创建
-空 sidecar、重算其 SHA-256，并把仅有空白或标点差异的金句归一为正文中的精确文本。真正的
-措辞差异仍会拒绝，避免静默改写正文。视觉计划的每张正文配图都必须
-提供唯一的 `placementAnchor: after-heading:<正文二级标题全文>`，交付 CLI 据此插入，找不到或
-重复匹配即拒绝预览。标题完成时必须存在不超过 32 个 Unicode 字符的最终标题；审校完成时
-必须是零阻断的 `pass`；交付完成时必须存在意图 ID、微信 MediaID 和完成状态。
-
-## 严格字段速查
-
-遇到 `STAGE_ARTIFACT_INVALID` 或 `DXC_PROJECT_STAGE_INVALID` 时，不要猜字段；先读取与当前
-CLI 版本匹配的本表、对应 Skill 模板和 CLI 返回的字段路径。所有 stage frontmatter 均为
-strict：未声明的键会被拒绝。
-
-| 产物                           | Agent 需要提供的语义字段                                                                    | CLI 负责的字段与约束                                                                                                                                      |
-| ------------------------------ | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `04-article.golden-lines.json` | 顶层 `schemaVersion: dxc-golden-lines@1` 与 `lines`；每条只含 `text`、`section`、`purpose`  | purpose 仅可为 `cognitive-compression`、`emotional-resonance`、`action-prompt`、`value-statement`；文本必须能在正文逐字找到，CLI 仅会归一空白或标点差异。 |
-| article                        | YAML 头、`title`、`author`、`goldenLinesPath`，以及实际需要的摘要、模板提示、标签和评论开关 | `dxc`、`goldenLinesSha256`、输入哈希、旧根级 `quoteSnapshots` 的迁移都由 checkpoint 规范化；不要手填机器元数据。                                          |
-| materialized visual-plan       | `coverAsset`、`coverSource`、每张 `inlineAssets` 的路径、用途、来源与唯一 `placementAnchor` | `assetsDirectory`、`inlineImagesSupported: true`、封面和内嵌图片 SHA-256 根据真实 PNG/JPEG 自动重算；不要手算或伪造哈希。                                 |
-| completed delivery             | 服务端回读的 `state: completed`、`intentId`、`mediaId` 以及最终模板回执                     | 交付完成 checkpoint 机械核对这三个完成条件；`previewed`、`processing` 或 `requires-attention` 都不能完成。                                                |
-
-微信摘要最多 120 个 Unicode 字符，标题最多 32 个，作者最多 16 个。预览命令应在任何网络请求前
-给出字段级错误；需要替换摘要或标题时使用预览阶段提供的覆盖值，不创建发布副本。
-
-## 状态
-
-- `running`：先写 checkpoint，再执行工作。
-- `completed`：输出非空、frontmatter 完整、内部自检通过。普通阶段不伪造用户确认。
-- `awaiting-user`：只有真实路线选择或最终采用决策；把原问题同时写入 `waitingFor`。
-- `failed`：写稳定错误码和可恢复边界。外部结果不确定时绝不盲目重试。
-- `skipped`：只用于用户已有可信下游产物的路线，并在摘要中说明来源和原因。
-
-宿主命令短暂不可用时，已落盘产物和 checkpoint 仍是真值。恢复必须先运行 `project status`，按
-`recoveryPlan` 从最早失效阶段继续；不得因为 Shell/Bash 瞬时失败重写已经完成的正文或下游产物。
-
-正文、最终标题和视觉计划都完成后，公开的项目级本地预览入口是
-`project preview --local [--directory <directory>] [--output <path>] --json`。CLI 从 checkpoint
-读取真实路径、标题和素材目录，并把返回结果标识为 `command: project.preview`。底层
-`wechat draft preview-local` 只为旧调用和隔离安装包验证保留，不应写入公开工作流步骤。
-
-checkpoint 必须写入 `project status` 返回的当前 `nextStage`。上游变化使某一步及其下游变为
-`stale` 后，必须从最早失效阶段重新执行；CLI 不接受直接重写更晚阶段来恢复“完成”。唯一例外
-是总控接管用户明确提供的可信 Markdown 正文：CLI 在写 `article` 检查点的同一动作中为
-`research`、`brief`、`outline` 建立 `skipped` 记录，且这些阶段不得已有产物或非跳过记录。
-
-Skill、执行位置、数据去向、输入输出哈希、摘要和等待问题必须同时落到 checkpoint。
-不得把 Cookie、Token、密码、请求头、绝对浏览器 Profile 路径或第三方全文写入元数据。
-
-## 确认绑定
-
-- 普通新检查点使用 `checkpointVersion: "3"`；需要记录阶段内图片生成授权时使用版本 4，
-  `authorizations` 保留计划快照、执行位置、数据去向、是否消耗额度、单次尝试限制、确认人和
-  确认时间。恢复任务不得在旧授权下重新调用图片生成。
-- 需要用户确认的阶段包含 `confirmationBinding`，记录
-  `snapshotHash`、`snapshotType` 和 `requestedAt`。
-- 用户确认后使用 `--confirm --confirmed-by <稳定身份标识>`；CLI 记录 `confirmedAt`
-  和 `confirmedBy`，并自动更新产物状态。没有更强身份来源时可使用
-  `local-interactive-user`，不得伪造姓名。
-- 正文绑定排除生命周期元数据后的文章内容哈希；标题绑定候选正文、上游正文哈希和
-  已选标题的内容哈希。只改变 `artifactStatus` 不会让确认失效，任何用户可见内容变化
-  都必须重新写 `awaiting-user` 并展示。所有内容阶段的确认哈希还绑定当前 `dxc.inputs`；
-  上游产物重做后，即使下游正文文字未变，旧确认也会失效。
-- 交付阶段额外传 `--confirmation-snapshot <renderSnapshot SHA-256>`；CLI 会核对它
-  必须等于交付产物中的 `selectedSnapshotHash`，不能由 Agent 任意填写。预览刷新与批准请求
-  使用 `rootSnapshotId/rootSnapshotHash`，批准后 CLI 必须把最终
-  `selectedSnapshotId/selectedSnapshotHash/templateId` 写回交付产物。
-- 非 delivery 阶段不得传 `--confirmation-snapshot`，也不要把整个 Markdown 文件的 SHA 当作
-  确认值；CLI 会自动计算排除生命周期元数据的语义快照。正文或标题改变后，先重新写
-  `awaiting-user` 并展示，再使用 `--confirm`。
-- `completed --confirm` 必须与前一个 `pending confirmationBinding` 的类型和哈希完全
-  一致；不一致时拒绝完成，先重新展示并写入新的 `awaiting-user` 检查点。
-- 需要确认的阶段若直接请求 `completed` 但没有 `--confirm`，CLI 会安全降级为
-  `awaiting-user` 并返回 `guidance`，不会把它写成异常或绕过确认门。