@aibyzero/byz 0.0.0 → 0.1.2

package/workflows/cm/docs/installation.md

@@ -0,0 +1,149 @@
+# Installation
+
+## Requirements
+
+- Git and Python 3.9 or newer.
+- For Codex: a current Codex installation with the bundled plugin creator
+  helpers available under `CODEX_HOME`.
+- For Claude Code on macOS/Linux: Bash 3.2 or newer.
+- For Claude Code on Windows: Windows PowerShell 5.1 or newer, plus Git for
+  Windows (Git Bash). WSL users can install and run the Bash entry inside WSL.
+
+Clone the repository somewhere other than `~/plugins/cm-workflow`:
+
+```bash
+git clone https://github.com/kingxiaozhe/cm-workflow.git
+cd cm-workflow
+```
+
+The Codex installer reserves `~/plugins/cm-workflow` as its managed install
+destination and refuses to replace a source checkout located there.
+
+## Codex
+
+```bash
+./install-codex.sh
+```
+
+The installer:
+
+1. validates the source with CM's dependency-free repository and runtime checks;
+2. also runs Codex's bundled YAML validator when PyYAML is available;
+3. updates the personal marketplace through the bundled scaffold helper;
+4. assembles and validates a temporary plugin;
+5. replaces the managed plugin directory, applies a cachebuster, and runs
+   `codex plugin add`.
+
+If the final Codex ingestion fails, both the previous managed plugin and the
+personal marketplace are restored. PyYAML is therefore an optional stronger
+validation dependency, not an installation prerequisite.
+
+Existing installs require confirmation. For an intentional unattended upgrade:
+
+```bash
+./install-codex.sh --yes
+```
+
+Start a new Codex thread after installation, then run `$cm-check`. To derive a
+test-case draft from an implemented feature, use
+`$cm-test {project} {feature} --generate-cases`; to verify it without modifying
+source, use `$cm-test`. The installed manual is available at
+`~/plugins/cm-workflow/docs/user-guide.md`.
+The optional project configuration template is installed at
+`~/plugins/cm-workflow/templates/cm-workflow.yml`.
+
+## Local cross-project logs
+
+The installers do not create or upload logs. On the first logged workflow
+event, the shared writer creates:
+
+```text
+~/.cm-workflow/logs/index.jsonl
+~/.cm-workflow/logs/runs/YYYY-MM/{run_id}.jsonl
+```
+
+Set `CM_WORKFLOW_LOG_HOME` before starting Codex or Claude Code to choose a
+different local root. On POSIX systems these global directories and files are
+restricted to the current user. They contain normalized operational metadata,
+not prompts, model responses, source text, external conversation URLs, or
+credentials. A specs-local `运行日志.jsonl` remains the authoritative record.
+
+## Claude Code on macOS/Linux
+
+```bash
+./install.sh
+```
+
+All CM-owned destination files are checked before any copy. The bundle is
+all-or-nothing: declining a conflict changes nothing, and a failed post-install
+check restores the previous CM files. Use `--yes` only when you intentionally
+accept replacement of all listed CM files:
+
+```bash
+./install.sh --yes
+```
+
+The installer runs the shared mechanical check before reporting success. Start a
+new Claude Code session, then run `/cm-check`. The installer also keeps the
+historic `/cm:check` alias on macOS/Linux. The installed manual is available at
+`~/.claude/cm-workflow/docs/user-guide.md` unless `CLAUDE_HOME` overrides the
+destination.
+The optional project configuration template is installed at
+`$CLAUDE_HOME/templates/cm-workflow.yml` (or `~/.claude/templates/cm-workflow.yml`).
+
+## Claude Code on Windows
+
+```powershell
+powershell -ExecutionPolicy Bypass -File install.ps1
+```
+
+Existing CM files are listed before replacement. Windows uses the same
+all-or-nothing transaction and restores the previous CM files if validation
+fails. Use `-Force` for an intentional unattended install:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File install.ps1 -Force
+```
+
+Core Markdown workflows use `/cm-*` names such as `/cm-check`, `/cm-ai`, and
+`/cm-test`. The PowerShell installer and `/cm-check` delegate the shared
+mechanical check to Git Bash; set `CLAUDE_CODE_GIT_BASH_PATH` if Bash is not on
+`PATH`. Windows cannot store the historic colon filenames used by `/cm:*`, so
+those aliases are macOS/Linux only. Bash-based statusline and visualization
+helpers likewise require WSL or Git Bash.
+The optional project configuration template is installed at
+`$CLAUDE_HOME/templates/cm-workflow.yml` (or `%USERPROFILE%\.claude\templates\cm-workflow.yml`).
+
+## Optional Claude auto-update (macOS/Linux)
+
+The Bash installer copies the updater on a best-effort basis but does not activate
+it. A copy failure is reported as a warning and does not invalidate a core runtime
+that already passed its installed self-check. The PowerShell
+installer intentionally does not copy this Bash-based updater; Windows users who
+want it must run the Bash installer from WSL or Git Bash. To enable it on a
+supported Bash environment, add the following commands to Claude Code's
+`hooks.SessionStart` configuration after reviewing the scripts:
+
+```json
+[
+  {
+    "type": "command",
+    "command": "~/.cm-workflow/cm-announce.sh",
+    "timeout": 5
+  },
+  {
+    "type": "command",
+    "command": "~/.cm-workflow/cm-update.sh",
+    "timeout": 120,
+    "async": true
+  }
+]
+```
+
+Set `CM_UPDATE_REMOTE` when your team intentionally uses a fork.
+
+## Uninstall
+
+This repository does not provide an automatic uninstall because user directories
+may contain modified copies. Remove only the CM-owned paths you have reviewed,
+or restore from your own backup.

package/workflows/cm/docs/sample-prd/prd-funding-rate-alert.md

@@ -0,0 +1,42 @@
+# 资金费率异常提醒工具 —— PRD
+
+> 成熟度：**L1 半成品骨架** ｜ 类型：B 开发者工具 / 脚本 ｜ 领域包：trading（已加载）
+
+## 问题陈述
+做期现套利/持有永续仓位时，资金费率转负或异常飙高意味着"利息"变"亏损"或出现入场机会，
+但人不可能 7×24 盯每 8 小时一次的结算。错过转负 = 白亏几期费率。
+
+## 核心方案
+一个自用 Python 脚本（服务器常驻），轮询币安全部 USDT 永续的预测/实时资金费率，
+命中规则时通过 Server酱 推送到微信。**只读行情、不碰账户、不下单。**
+
+## 目标用户
+自己（单用户自用，无账户体系）。
+
+## 用户故事（标题级）
+1. 持仓币种费率**转负**时，8 小时结算前收到微信提醒
+2. 任意币种费率**异常飙高**（>0.10%/8h）时收到"机会提醒"
+3. 同一异常**不重复轰炸**（同币同状态 24h 内只推一次）
+4. 每天早上收到一条**费率 TOP5 日报**（可关）
+5. 脚本挂了或 API 连续失败时，收到**存活告警**（防"静默失联以为天下太平"）
+
+## 触发规则（首版，可调参数）
+- 转负提醒：预测费率 < 0 且我在自选清单里标了"持仓"
+- 机会提醒：预测费率 > +0.10%/8h（全市场扫描）
+- 去重：同币种同规则 24h 冷却；日报每天 09:00 一条
+
+## 成功指标（含领域包强制的风险口径）
+- 持仓币转负的提醒**漏报 = 0**（核心存在性指标）
+- 提醒到达延迟 < 10 分钟（费率 8h 结算，10min 足够）
+- 脚本静默失联 > 30 分钟必有存活告警 —— 监控工具自己不能是黑箱
+
+## 范围边界
+- ✅ 币安 USDT 永续（单交易所起步）
+- ❌ 不下单、不自动平仓、不接交易 Key（纯只读，无资金风险面）
+- ❌ 不做多交易所、不做网页界面（都留到验证有用之后）
+
+## ⚠️ 待明确的问题（领域包强制项）
+- **Key 安全**：行情接口无需 Key；若日后加"我的持仓"自动识别，需只读 Key + 禁提现校验（三道闸）
+- **极端行情处置**：币安 API 限频/宕机时的退避与告警策略（骨架已含存活告警，参数待定）
+- **合规边界**：纯自用监控工具、不代客、不荐股 → 无监管定性问题；若日后分享给他人需重估（领域包红线）
+- **阈值科学性**：+0.10%/8h 是经验值，跑两周真实数据后回看调参 ⚠️ 待补

package/workflows/cm/docs/sample-specs/docs//351/234/200/346/261/202/347/244/272/344/276/213.md

@@ -0,0 +1,24 @@
+# 测试需求：极简 Todo 应用
+
+## 背景
+
+用于验证 cm 工作流的最小需求，规模刻意控制在 3–5 个任务。
+
+## 功能需求
+
+1. 用户可以添加一条待办事项（文本，不超过 200 字）
+2. 用户可以将待办标记为完成/取消完成
+3. 用户可以删除待办
+4. 列表按创建时间倒序展示，已完成项置灰
+
+## 非功能需求
+
+- 数据本地持久化即可（localStorage 或 SQLite，实现方自选）
+- 单页应用，无需登录
+- 界面简洁可用即可，无设计稿
+
+## 验收标准
+
+- 添加后刷新页面数据不丢失
+- 完成状态切换即时生效
+- 删除有一次确认