@aibyzero/byz 0.0.0 → 0.1.1

package/examples/sdk/README.md

@@ -0,0 +1,140 @@
+# SDK Examples
+
+Programmatic usage of pi-coding-agent via `createAgentSession()` and `createAgentSessionRuntime()`.
+
+The runtime example shows how to build a recreate function that closes over process-global fixed inputs and recreates cwd-bound services and sessions as the active session cwd changes.
+
+## Examples
+
+| File | Description |
+|------|-------------|
+| `01-minimal.ts` | Simplest usage with all defaults |
+| `02-custom-model.ts` | Select model and thinking level |
+| `03-custom-prompt.ts` | Replace or modify system prompt |
+| `04-skills.ts` | Discover, filter, or replace skills |
+| `05-tools.ts` | Built-in tool allowlists |
+| `06-extensions.ts` | Logging, blocking, result modification |
+| `07-context-files.ts` | AGENTS.md context files |
+| `08-slash-commands.ts` | File-based slash commands |
+| `09-api-keys-and-oauth.ts` | API key resolution, OAuth config |
+| `10-settings.ts` | Override compaction, retry, terminal settings |
+| `11-sessions.ts` | In-memory, persistent, continue, list sessions |
+| `12-full-control.ts` | Replace everything, no discovery |
+| `13-session-runtime.ts` | Manage runtime-backed session replacement |
+
+## Running
+
+```bash
+cd packages/coding-agent
+npx tsx examples/sdk/01-minimal.ts
+```
+
+## Quick Reference
+
+```typescript
+import { getModel } from "@earendil-works/pi-ai";
+import {
+  createAgentSession,
+  DefaultResourceLoader,
+  ModelRuntime,
+  SessionManager,
+  SettingsManager,
+} from "@earendil-works/pi-coding-agent";
+
+const modelRuntime = await ModelRuntime.create();
+
+// Minimal
+const { session } = await createAgentSession({ modelRuntime });
+
+// Custom model
+const model = getModel("anthropic", "claude-opus-4-5");
+const { session } = await createAgentSession({ model, thinkingLevel: "high", modelRuntime });
+
+// Modify prompt
+const loader = new DefaultResourceLoader({
+  systemPromptOverride: (base) => `${base}\n\nBe concise.`,
+});
+await loader.reload();
+const { session } = await createAgentSession({ resourceLoader: loader, modelRuntime });
+
+// Read-only
+const { session } = await createAgentSession({ tools: ["read", "grep", "find", "ls"], modelRuntime });
+
+// In-memory
+const { session } = await createAgentSession({
+  sessionManager: SessionManager.inMemory(),
+  modelRuntime,
+});
+
+// Full control
+const customRuntime = await ModelRuntime.create({
+  authPath: "/my/app/auth.json",
+  modelsPath: "/my/app/models.json",
+});
+await customRuntime.setRuntimeApiKey("anthropic", process.env.MY_KEY!);
+
+const resourceLoader = new DefaultResourceLoader({
+  systemPromptOverride: () => "You are helpful.",
+  extensionFactories: [myExtension],
+  skillsOverride: () => ({ skills: [], diagnostics: [] }),
+  agentsFilesOverride: () => ({ agentsFiles: [] }),
+  promptsOverride: () => ({ prompts: [], diagnostics: [] }),
+});
+await resourceLoader.reload();
+
+const { session } = await createAgentSession({
+  model,
+  modelRuntime: customRuntime,
+  resourceLoader,
+  tools: ["read", "bash", "my_tool"],
+  customTools: [myTool],
+  sessionManager: SessionManager.inMemory(),
+  settingsManager: SettingsManager.inMemory(),
+});
+
+// Run prompts
+session.subscribe((event) => {
+  if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+    process.stdout.write(event.assistantMessageEvent.delta);
+  }
+});
+await session.prompt("Hello");
+```
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `modelRuntime` | Runtime using `agentDir/auth.json` and `models.json` | Canonical model and authentication runtime |
+| `cwd` | `process.cwd()` | Working directory |
+| `agentDir` | `~/.pi/agent` | Config directory |
+| `model` | From settings/first available | Model to use |
+| `thinkingLevel` | From settings/"off" | off, low, medium, high |
+| `tools` | `["read", "bash", "edit", "write"]` built-ins | Allowlist tool names across built-in, extension, and custom tools |
+| `customTools` | `[]` | Additional tool definitions |
+| `resourceLoader` | DefaultResourceLoader | Resource loader for extensions, skills, prompts, themes, and context files |
+| `sessionManager` | `SessionManager.create(cwd)` | Persistence |
+| `settingsManager` | `SettingsManager.create(cwd, agentDir)` | Settings overrides |
+
+## Events
+
+```typescript
+session.subscribe((event) => {
+  switch (event.type) {
+    case "message_update":
+      if (event.assistantMessageEvent.type === "text_delta") {
+        process.stdout.write(event.assistantMessageEvent.delta);
+      }
+      break;
+    case "tool_execution_start":
+      console.log(`Tool: ${event.toolName}`);
+      break;
+    case "tool_execution_end":
+      console.log(`Result: ${event.result}`);
+      break;
+    case "agent_settled":
+      console.log("Done");
+      break;
+  }
+});
+```

package/package.json

@@ -1,14 +1,67 @@
 {
-  "name": "@aibyzero/byz",
-  "version": "0.0.0",
-  "description": "Bootstrap placeholder for BYZ trusted publishing",
-  "license": "MIT",
-  "author": "Zero / 王者与",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/kingxiaozhe/byz.git"
-  },
-  "files": [
-    "README.md"
-  ]
+	"name": "@aibyzero/byz",
+	"version": "0.1.1",
+	"description": "Business-first coding agent built on Pi",
+	"type": "module",
+	"piConfig": {
+		"name": "byz",
+		"configDir": ".byz"
+	},
+	"bin": {
+		"byz": "dist/cli.js"
+	},
+	"main": "./dist/runtime/bundle/index.js",
+	"types": "./dist/runtime/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/runtime/index.d.ts",
+			"import": "./dist/runtime/bundle/index.js"
+		},
+		"./rpc-entry": {
+			"import": "./dist/runtime/bundle/rpc-entry.js"
+		}
+	},
+	"files": [
+		"dist",
+		"CHANGELOG.md",
+		"docs",
+		"examples",
+		"LICENSE",
+		"README.md",
+		"upstream.json",
+		"workflows.lock.json",
+		"workflows"
+	],
+	"scripts": {
+		"clean": "node ./scripts/clean.mjs",
+		"build": "node ./scripts/build.mjs",
+		"test": "node --test test/*.test.mjs"
+	},
+	"dependencies": {
+		"@silvia-odwyer/photon-node": "0.3.4",
+		"jiti": "2.7.0",
+		"semver": "7.8.0"
+	},
+	"optionalDependencies": {
+		"@mariozechner/clipboard": "0.3.9"
+	},
+	"engines": {
+		"node": ">=22.19.0"
+	},
+	"keywords": [
+		"coding-agent",
+		"ai",
+		"pi",
+		"business-first"
+	],
+	"author": "Zero / 王者与",
+	"license": "MIT",
+	"homepage": "https://byz.aibyzero.com",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/kingxiaozhe/byz.git"
+	},
+	"devDependencies": {
+		"@aibyzero/cm-workflow": "github:kingxiaozhe/cm-workflow#f181e3169a8deb3adf431860c30214fd49c249d7"
+	}
 }

package/upstream.json

@@ -0,0 +1,6 @@
+{
+	"repository": "https://github.com/earendil-works/pi",
+	"commit": "8fa7eebd235355522c8104166b4f1f959b4e2f10",
+	"codingAgentVersion": "0.84.3",
+	"checkedAt": "2026-08-25"
+}

package/workflows/cm/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kingxiaozhe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/workflows/cm/README.md

@@ -0,0 +1,333 @@
+<p align="center">
+  <img src="./assets/readme/hero.svg" width="100%" alt="CM means Create More：CM Workflow 让想法成为可审查、可测试、可恢复的代码交付">
+</p>
+
+<p align="center">
+  <a href="https://github.com/kingxiaozhe/cm-workflow/actions/workflows/ci.yml"><img src="https://github.com/kingxiaozhe/cm-workflow/actions/workflows/ci.yml/badge.svg" alt="CI status"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-151515" alt="MIT License"></a>
+  <img src="https://img.shields.io/badge/Codex-native-2E6655" alt="Codex native">
+  <img src="https://img.shields.io/badge/Claude%20Code-compatible-C44B32" alt="Claude Code compatible">
+</p>
+
+<p align="center">
+  <strong>CM means Create More.</strong><br>
+  从一句需求开始，留下规格、代码、测试、审查与可恢复的交付记录。
+</p>
+
+<p align="center">
+  <a href="#安装">安装</a> ·
+  <a href="#我现在该用哪个命令">选择命令</a> ·
+  <a href="#跑通第一条开发流程">完整流程</a> ·
+  <a href="docs/user-guide.md">使用手册</a> ·
+  <a href="docs/architecture.md">架构说明</a>
+</p>
+
+## 它解决什么问题
+
+AI 可以很快写代码，但“写完”不等于“可以交付”。需求有没有理解错、修改是否越界、
+测试是否真的执行、换一个会话能不能继续，这些问题仍然需要一套明确流程。
+
+CM Workflow 是一套安装在 **Codex** 或 **Claude Code** 中的本地、规格驱动开发工作流：
+
+```text
+需求 → 规格 → 人工确认 → 实现 → 独立审查 → 测试与 QA → 分支 / Draft MR
+```
+
+它不替你决定产品方向，也不自动获得远端权限。它做的是把 AI 开发从一次聊天，变成
+有边界、有证据、可以暂停和恢复的工程过程。
+
+> **No evidence → no completion.** `tasks.md` 是任务状态的唯一权威来源；聊天进度、
+> Agent 状态和界面提示都不能替代磁盘中的任务、审查与测试凭证。
+
+## 我现在该用哪个命令
+
+第一次使用，只需要记住下面这张表：
+
+| 你现在想做什么 | 从这里开始 | 接下来 |
+| --- | --- | --- |
+| 只有一个模糊点子 | `$cm-idea` | 形成 PRD 后进入 `$cm-prd` |
+| 开发一个明确的新需求 | `$cm-prd {specs路径}` | 人工确认后运行 `$cm-ai` |
+| 第一次接管已有仓库 | `$cm-init` | 再运行 `$cm-prd` |
+| 测试已经存在的功能 | `$cm-test {项目路径} {功能} --generate-cases` | 检查用例后运行 `$cm-test --all` |
+| 修复可复现 Bug | `$cm-fix {specs路径} {项目路径} {问题}` | 红灯测试 → 最小修复 → 回归 |
+| 只整理代码结构 | `$cm-refactor` | 在行为等价约束下分批重构 |
+| 不确定是否安装正确 | `$cm-check` | 按检查结果修复环境 |
+| 讨论方案或研究复杂问题 | `$external-expert` | 外部研究，本地核验，不负责编码 |
+
+完整参数和更多场景见 [使用手册：我现在该用哪个命令？](docs/user-guide.md#我现在该用哪个命令)。
+
+## 安装
+
+需要 Git、Python 3.9+，以及 Codex 或 Claude Code。源码不要克隆到
+`~/plugins/cm-workflow`，该路径由 Codex 安装器管理。
+
+### Pi / BYZ package
+
+仓库包含原生 Pi package manifest。直接作为 Pi package 使用时，不会运行
+`install.sh`、hook 或自动更新脚本：
+
+```bash
+pi install git:github.com/kingxiaozhe/cm-workflow
+```
+
+BYZ 可以把同一包固定到指定版本后随发行物提供，开发时仍可使用本地 package
+路径覆盖。包内 Skills 与 Prompts 由 Pi 资源加载器直接发现，不会复制到用户的
+Codex 或 Claude Code 全局目录。
+
+### Codex
+
+```bash
+git clone https://github.com/kingxiaozhe/cm-workflow.git
+cd cm-workflow
+./install-codex.sh
+```
+
+新开一个 Codex 任务，验证安装：
+
+```text
+$cm-check
+```
+
+### Claude Code
+
+macOS / Linux：
+
+```bash
+./install.sh
+```
+
+Windows PowerShell：
+
+```powershell
+powershell -ExecutionPolicy Bypass -File install.ps1
+```
+
+新开 Claude Code 会话并运行 `/cm-check`。macOS/Linux 同时保留历史 `/cm:*` 别名；
+Windows 需要 Git for Windows（Git Bash），也可以在 WSL 中使用 Bash 入口。
+
+覆盖安装、无人值守模式和可选更新器见 [安装指南](docs/installation.md)。
+
+## 跑通第一条开发流程
+
+<p align="center">
+  <img src="./assets/readme/delivery-flow.svg" width="100%" alt="CM Workflow 从需求登记、规格成档、人工确认、逐任务实现、独立审查到 QA 归档的交付流程">
+</p>
+
+假设代码位于 `~/code/my-app`，规格准备放在 `~/projects/my-app-specs`。
+
+### 1. 接管已有项目
+
+```bash
+cd ~/code/my-app
+```
+
+```text
+$cm-init
+```
+
+全新空项目跳过 `$cm-init`，直接从下一步开始。
+
+### 2. 生成可开发规格
+
+把 PRD、需求说明、原型或测试意图放入 specs 的 `docs/`，然后运行：
+
+```text
+$cm-prd ~/projects/my-app-specs
+```
+
+它会生成每个 Feature 的：
+
+```text
+requirements.md   # 用户故事与验收条件
+design.md         # 技术方案与边界
+tasks.md          # 可执行任务，也是唯一权威任务状态
+test-cases.json   # 可选的 AI 可读测试合同
+```
+
+CM PRD 的方案审查与任务拆分审查各自最多调用一次独立 reviewer。中断后会复用已生成的
+审查凭证和处置回执，不会因为恢复流程而重复发起同一轮对抗审查。
+
+### 3. 人工确认后开始实现
+
+先检查规格摘要、技术方案、任务和验收条件。确认无误后运行：
+
+```text
+$cm-ai ~/projects/my-app-specs ~/code/my-app
+```
+
+规格批准会绑定 requirements、design、tasks 与测试合同的语义 manifest。N5/N6 正常
+勾选任务和 AC 不会被误判为规格变化；文案、ID、方案或测试目标变化仍会要求重新审批。
+
+### 4. 获得可审查交付
+
+根据项目 `.cm-workflow.yml` 中的 `delivery`，流程可以交付：
+
+- `diff`：只留下本地修改和验证结果；
+- `branch`：提交到本地任务分支；
+- `draft-mr`：在你明确授权 push 和创建 MR/PR 后，提交 GitHub 或 GitLab Draft MR。
+
+配置不会自动授予远端权限，生产发布也始终保留人工确认。
+
+## 测试已有功能
+
+已有功能没有测试用例时，可以先让 CM 读取代码路径和分支逻辑，生成 AI 可读用例草稿：
+
+```text
+$cm-test ~/code/my-app 用户登录 --generate-cases
+```
+
+确认用例后，按需执行全部测试层：
+
+```text
+$cm-test ~/code/my-app --specs ~/projects/my-app-specs --feature 2.user-login --all
+```
+
+<p align="center">
+  <img src="./assets/readme/test-evidence.svg" width="100%" alt="CM Workflow 分别记录逻辑检查、正式命令和浏览器用户路径三类测试证据">
+</p>
+
+三类证据不会互相冒充：
+
+- **logic**：读取代码入口、分支、状态变化与输出，只能说明逻辑是否支持；
+- **commands**：真实运行项目声明的测试、类型检查和构建命令，保存退出结果；
+- **browser**：按照测试用例模拟用户操作，记录动作、URL、可观察结果、截图与日志。
+
+`$cm-test` 默认只读：不改源码、不自动安装依赖、不降低断言，也不会把静态分析写成
+“测试已通过”。需要修复时，再明确进入 `$cm-fix`。
+
+## 一条核心，八个节点
+
+`$cm-ai` 始终按 N1–N8 执行。角色和模型可以配置，流程责任不随模型变化。
+
+| 节点 | 责任 | 完成证据 |
+| --- | --- | --- |
+| N1 初始化 | 读取规格、审批状态、项目配置和恢复指针 | 规格已明确批准 |
+| N2 Feature | 加载任务、测试合同、依赖与历史经验 | 当前范围清晰 |
+| N3 Task | 由匹配工种修改当前任务范围内的代码 | 结构化 handoff |
+| N4 Review | 新上下文独立审查修改与测试覆盖 | `.reviews/` verdict |
+| N5 完成 | 回读证据、勾选任务并按策略提交 | `tasks.md` 与提交记录 |
+| N6 QA | 运行逻辑、正式命令和可选浏览器路径 | 真实 QA 结果 |
+| N7 重载 | 从磁盘重新建立上下文 | 不依赖旧聊天记忆 |
+| N8 收尾 | 同步文档、对账凭证、汇总日志并交付 | diff / branch / Draft MR |
+
+默认串行执行。只有依赖、文件边界、契约和 Worktree 隔离都满足时才允许并行写入；
+specs、任务状态、审查、度量与 Git 始终保持单写权。
+
+## 角色与模型可以配置
+
+复制模板到代码项目根目录：
+
+```bash
+cp /path/to/cm-workflow/templates/cm-workflow.yml .cm-workflow.yml
+```
+
+项目可以配置这些流程角色：
+
+```text
+analyst · planner · coder · tester · reviewer · browser_qa · external_expert
+```
+
+以及有限的执行策略：
+
+```yaml
+policies:
+  generate_cases: true
+  tests: [logic, commands, browser]
+  auto_fix: explicit
+  delivery: draft-mr
+```
+
+角色可以声明本地、订阅或 API 模型适配器；配置只记录请求路由，不保存 API Key、
+Token、Cookie 或 Prompt，也不会改变 N1–N8 的顺序。当前运行时没有接入某个适配器时，
+只记录 `declared-adapter`，不会声称对应模型已经执行；没有匹配角色时，由当前 AI 在
+相同合同下直接执行。内置 `openai-compatible` 可用于分析、规划和编码辅助，但版本 1
+不允许配置为 `reviewer`；N4 仍需新上下文的本地独立审查凭证。
+
+配置字段与运行时投影见 [Workflow 配置合同](runtime/workflow-config.md) 和
+[角色路由合同](runtime/workflow-routing.md)。
+
+## 外部专家负责思考，不接管代码
+
+`$external-expert` 适合产品讨论、技术方案、问题研究、学术研究、测试设计和对抗核验。
+它可以使用外部高能力模型，但始终是可选的研究通道：
+
+- 编码、命令、浏览器 QA、Git 和 N4 审查仍由本地流程负责；
+- `.env`、密钥、Token、Cookie、客户数据和数据库禁止外发；
+- 外部回答是待核验材料，不能直接成为测试或完成证据；
+- Pro 路由不可用时按既定策略降级，所有等级不可用就回到本地流程。
+
+完整边界见 [External Expert 合同](runtime/external-expert.md)。
+
+## 换一个会话，也能继续
+
+<p align="center">
+  <img src="./assets/readme/recovery-record.svg" width="100%" alt="新会话从任务、测试意图、审查证据、状态和运行日志恢复 CM Workflow">
+</p>
+
+CM 不把聊天记录当数据库。每个 specs 项目都会留下可恢复记录：
+
+| 文件 | 作用 |
+| --- | --- |
+| `requirements.md` / `design.md` / `tasks.md` | 需求、方案和唯一权威任务状态 |
+| `test-cases.json` | 可选的 AI 可读测试意图 |
+| `.cm-specs-status` | 人工审批状态与完整规格语义 manifest |
+| `.cm-status.json` / `.cm-run.json` | 当前节点和运行恢复指针 |
+| `.reviews/` | task handoff、独立 verdict、PRD 处置回执与测试凭证 |
+| `运行日志.jsonl` | 项目内权威事件日志 |
+| `METRICS.md` / `LESSONS.md` | 执行度量与可复用经验 |
+
+跨项目查看日志时，可以读取本机私有镜像：
+
+```text
+~/.cm-workflow/logs/
+├── index.jsonl
+└── runs/YYYY-MM/{run_id}.jsonl
+```
+
+它只是可重建的本机分析镜像，不是遥测服务，也不保存源码、Prompt、模型回答或凭证。
+
+## Codex 与 Claude 共用同一核心
+
+| 环境 | 入口 | 安装方式 |
+| --- | --- | --- |
+| Codex | `$cm-*` | `./install-codex.sh` |
+| Claude Code macOS/Linux | `/cm-*`，兼容 `/cm:*` | `./install.sh` |
+| Claude Code Windows | `/cm-*` | `install.ps1` |
+
+Codex Skills 与 `runtime/` 是权威实现；Claude Code 使用同一组 Skills 和合同，兼容命令
+只负责入口映射，不维护第二套流程。
+
+## 人工与安全边界
+
+以下动作不会因为流程自动化而被默认授权：
+
+- 规格进入编码前的最终批准；
+- push、创建 MR/PR 和生产发布；
+- 密钥、凭证或权限变更；
+- 破坏性 migration 与真实资金操作；
+- 超出已审批任务范围的修改。
+
+仓库不运行常驻服务、不收集遥测，也不保存你的模型凭证。仅在你主动启用可选
+OpenAI-compatible 适配器时，本地进程会从环境变量读取 API Key。CI 会验证运行时合同、安装器、
+公开包内容、Shell/PowerShell 兼容性与 Git 历史密钥扫描。安全问题请按
+[SECURITY.md](SECURITY.md) 私下报告。
+
+## 维护与贡献
+
+修改工作流后运行：
+
+```bash
+./scripts/cm-check-runtime.sh
+bash scripts/test-shell-compat.sh
+python3 scripts/validate-public-repo.py
+python3 scripts/scan-public-safety.py
+python3 ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py .
+```
+
+基础版本同时保存在 `VERSION` 与 `.codex-plugin/plugin.json`；Codex 安装副本会追加
+`+codex.*` cachebuster。贡献前请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。
+
+## License
+
+[MIT License](LICENSE)。Darwin Skill 与 Kenney CC0 素材来源见
+[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

package/workflows/cm/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,29 @@
+# Third-party notices
+
+CM Workflow is MIT licensed. The following bundled materials retain their own
+attribution and license status.
+
+## Darwin Skill
+
+- Source: https://github.com/alchaincyf/darwin-skill
+- Upstream author: 花叔 Huashu (`alchaincyf`)
+- License declared by upstream: MIT
+- Bundled path: `skills/darwin-skill/`
+
+The upstream repository did not contain a standalone `LICENSE` file when this
+copy was imported. Its README explicitly declares “MIT” in the license section
+and “MIT License © 花叔 Huashu”. The local `NOTICE.md` records the imported
+files and portability changes. The repository-level MIT license supplies the
+full license text; this notice preserves the upstream attribution.
+
+## Kenney pixel assets
+
+The following source sheets and the generated `atlas-preview.png` are derived
+from Kenney assets released under Creative Commons CC0 1.0:
+
+- `roguelikeIndoor_transparent.png` — [Roguelike Indoors](https://kenney.nl/assets/roguelike-indoors)
+- `roguelikeCity_tilemap.png` — [Roguelike Modern City](https://kenney.nl/assets/roguelike-modern-city)
+- `roguelikeChar_transparent.png` — [Roguelike Characters](https://kenney.nl/assets/roguelike-characters)
+
+License: [CC0 1.0 Universal](https://creativecommons.org/publicdomain/zero/1.0/).
+Attribution is not required by CC0, but is retained here for provenance.

package/workflows/cm/VERSION

@@ -0,0 +1 @@
+0.10.4

package/workflows/cm/agents/cm-backend-agent.md

@@ -0,0 +1,34 @@
+---
+name: cm-backend-agent
+description: 后端 API 开发子 agent。由 /cm-ai 在并行执行后端任务时派发，负责流程纪律（任务边界、上下文、汇报、退出），具体开发规范由 cm-backend-engineer skill 提供。
+---
+
+# cm-backend-agent — 后端开发子 agent
+
+你是被主流程派发的后端 API 开发子 agent。**agent 管纪律，skill 管技术**——你的职责是守住流程边界，开发方法完全遵循 skill。
+
+## 执行流程
+
+1. **加载 skill**：读取并严格遵循 `cm-backend-engineer` skill，它是开发方法的唯一准则
+2. **读取上下文**：派发指令中给出的 specs 摘录（requirements/design/tasks 相关部分）+ 代码项目的 `.claude/CLAUDE.md` 和 `.claude/rules/`
+3. **只做指定任务**：严格按派发指令中的任务编号（T-xxx）执行，不顺手做其他任务
+
+## 边界约束（不可违反）
+
+- **不修改**任务范围之外的文件；发现必须跨界的改动 → 停止并在汇报中说明
+- **不自行标记** tasks.md —— 标记完成是主流程 N5 的职责
+- **不自行执行** review —— 审查是主流程 N4 的职责
+- **不得修改 `.claude/` 下任何文件**（CLAUDE.md、rules/）——规范异议写入汇报，由主流程处理
+- **不修改 design.md** —— 契约偏差走三级协议第 1 级：只报不改，写入汇报「契约相关」栏
+- **任务范围之外的鉴权/权限/会话逻辑改动 → 立即停止并上报**；任务本身即鉴权任务则正常执行（人工把关已在规格审查完成，QA 由 N6 强制触发兜底）
+
+## 完成后汇报（固定格式）
+
+```text
+📦 T-{编号} 完成汇报
+- 变更文件: {列表}
+- 验证结果: {lint / build / 接口实测结果}
+- 契约相关: {逐条列出实现的接口及与 design.md 的偏差，无偏差写"完全一致"}
+- 需其他工种配合: {事项，无则写"无"}
+- 建议写入 LESSONS: {要点，无则写"无"}
+```

package/workflows/cm/agents/cm-contract-agent.md

@@ -0,0 +1,34 @@
+---
+name: cm-contract-agent
+description: 智能合约开发子 agent。由 /cm-ai 在并行执行合约任务时派发，负责流程纪律（任务边界、上下文、汇报、退出），具体开发规范由 cm-contract-engineer skill 提供。
+---
+
+# cm-contract-agent — 合约开发子 agent
+
+你是被主流程派发的智能合约开发子 agent。**agent 管纪律，skill 管技术**——你的职责是守住流程边界，开发方法完全遵循 skill。
+
+## 执行流程
+
+1. **加载 skill**：读取并严格遵循 `cm-contract-engineer` skill，它是开发方法的唯一准则
+2. **读取上下文**：派发指令中给出的 specs 摘录 + 代码项目的 `.claude/CLAUDE.md` 和 `.claude/rules/`
+3. **只做指定任务**：严格按派发指令中的任务编号（T-xxx）执行，不顺手做其他任务
+
+## 边界约束（不可违反）
+
+- **不修改**任务范围之外的文件；发现必须跨界的改动 → 停止并在汇报中说明
+- **不自行标记** tasks.md —— 标记完成是主流程 N5 的职责
+- **不自行执行** review —— 审查是主流程 N4 的职责
+- **不得修改 `.claude/` 下任何文件**（CLAUDE.md、rules/）——规范异议写入汇报，由主流程处理
+- **绝不执行主网部署、绝不接触私钥**；部署脚本只准备、不执行，交主流程走人工确认
+- 权限模型（owner/admin/multisig）的任何调整 → 停止并上报
+
+## 完成后汇报（固定格式）
+
+```text
+📦 T-{编号} 完成汇报
+- 变更文件: {合约 / 测试 / 部署脚本列表}
+- 验证结果: {测试通过数 + 覆盖率}
+- 契约相关: {ABI 变更、事件定义、前端需要的合约地址占位，无则写"无"}
+- 需其他工种配合: {事项，无则写"无"}
+- 建议写入 LESSONS: {要点，无则写"无"}
+```