moluoxixi-ai-rules 0.2.13 → 0.2.14

package/README-en.md

@@ -379,6 +379,20 @@ Use `init-project` only for first-time setup, adding a host, or reconfiguration.
 
 Role source: [`roles/trellis`](roles/trellis).
 
+## `memory-superpowers`
+
+### Install
+
+This experimental role supports Codex, Claude Code, and Cursor. Once the role is available from the remote distribution source, install it with `airules install memory-superpowers --host codex` and check it with `airules verify memory-superpowers --host codex`. It requires uv, Git, Python 3.12, and network access for the initial pinned dependency downloads. See the [role guide](roles/memory-superpowers/README.md) for initialization commands and host options.
+
+### Features
+
+Provides project-local Basic Memory, official Superpowers skills, and an on-demand BMAD requirements review entry point. It does not inherit the general/development tools or install additional plugins or hooks.
+
+### Usage
+
+Initialize each target project with `memory-superpowers` after installing the role. The `review-requirements` skill can be used independently. See the [role guide](roles/memory-superpowers/README.md) and [verification record](roles/memory-superpowers/VERIFICATION.md) for configuration, shared source indexes, and validation limits. Host file projection and MCP protocol tests do not establish real host chat behavior.
+
 ## Shared distribution
 
 Shared skills, MCP catalogs, and vendor declarations live together in `capabilities/<capability>/`, such as `capabilities/common/skills/`. Each capability is a data-only directory containing `capability.yaml`, skills, MCP catalogs, and documentation. v2 roles select shared capabilities in `provides.capabilities` and keep their own installation settings in `installation`. The runtime loader lives in `scripts/lib/capabilities.ts`, composes vendors in declaration order, merges compatible projections, deduplicates identical projections, and rejects source or target conflicts. See [capabilities/README.md](capabilities/README.md) for the layout and complete mapping.

package/README.md

@@ -386,6 +386,20 @@ Plan 阶段创建并确认 PRD，复杂任务补齐 design/implement 后 `task.p
 
 角色源码位于 [`roles/trellis`](roles/trellis)。
 
+## `memory-superpowers`
+
+### 安装
+
+实验性角色，支持 Codex、Claude Code、Cursor。角色进入远程分发源后，使用 `airules install memory-superpowers --host codex` 安装，并通过 `airules verify memory-superpowers --host codex` 校验。需要 uv、Git 和 Python 3.12；首次初始化需要联网下载固定版本依赖。完整命令与宿主参数见[使用说明](roles/memory-superpowers/README.md)。
+
+### 功能
+
+提供项目独立的本地 Basic Memory、官方 Superpowers 技能，以及按需安装的 BMAD 研发需求评审入口。不继承 general/development 的工具，也不安装额外插件或 hooks。
+
+### 用法
+
+安装角色后，对每个目标项目执行 `memory-superpowers` 初始化；需求评审可独立使用 `review-requirements`。配置、团队索引和验证范围见[使用说明](roles/memory-superpowers/README.md)与[验证记录](roles/memory-superpowers/VERIFICATION.md)。宿主文件投影和 MCP 协议测试不等于真实聊天验收。
+
 ## 公共分发机制
 
 共享 skills、MCP 清单和供应商声明按能力集中在 `capabilities/<能力>/`，例如 `capabilities/common/skills/`。每个能力目录是纯数据目录，只包含 `capability.yaml`、skills、MCP 清单和文档；Role 在 v2 `role.yaml` 的 `provides.capabilities` 中选择 capability，把自身安装设置放在 `installation`。运行时加载器位于 `scripts/lib/capabilities.ts`，负责按声明顺序组合 vendor，合并兼容投影、去重完全相同的 projection，并拒绝来源或目标冲突。目录结构与完整映射见 [capabilities/README.md](capabilities/README.md)。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "moluoxixi-ai-rules",
   "type": "module",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "Remote AI role asset distribution for supported hosts.",
   "license": "MIT",
   "repository": "https://github.com/moluoxixi/AIRules",

package/roles/memory-superpowers/README.md

@@ -0,0 +1,79 @@
+# memory-superpowers（实验版）
+
+独立角色，使用 Basic Memory 和 Superpowers，附带按需安装的 BMAD 研发需求评审入口；不继承 general/development 的 Hindsight 等工具。
+
+## 安装
+
+```sh
+airules install memory-superpowers --host codex
+airules verify memory-superpowers --host codex
+uv run "$HOME/.agents/skills/memory-superpowers/scripts/project.py" init --project /absolute/project --host codex
+```
+
+若安装器投影采用命名空间，请从安装输出定位 `memory-superpowers/SKILL.md`，以其所在目录替换上述 skill 路径。Claude Code 和 Cursor 分别使用 `--host claude`、`--host cursor`。安装 AIRules role 仅分发初始化技能；**每个目标项目必须执行 init**。依赖 uv、Git、Python 3.12（uv 可管理）及首次联网下载。uv 缓存复用固定版本 Python 依赖；官方技能按固定 commit 检出，不修改源码，不额外安装插件或 hooks。
+
+当前只声明仓库宿主范围中的 Codex、Claude Code、Cursor。Codex 使用项目 `.codex/config.toml` 和 `.agents/skills`；Claude 使用 `.mcp.json`、`.claude/skills`、CLAUDE.md；Cursor 使用 `.cursor/mcp.json` 和 `.cursor/skills`。启动宿主后按宿主要求信任项目并启用 MCP。其它平台尚未验证，不声明支持。现有规则文件只追加一次入口，现有 MCP 使用增量合并；同名异配置报错保留原值。hooks 不变。新建的项目 MCP 文件加入忽略；若已有 MCP 文件受 Git 管理，生成的绝对路径条目应留在本地，不要随其他配置一起提交。初始化失败后修复原因重跑，不宣称原子回滚。
+
+## 配置
+
+复用已有 Moluoxixi YAML 项目配置 `.moluoxixi/config.yaml`。AIRules 公共安装器目前没有通用项目配置 API；独立项目使用同样的 YAML 约定 `.airules/config.yaml`，不引入配置依赖服务。可用 `--config /absolute/existing.yaml` 指向已有配置，**后续 init/bm 使用相同选项**。初始化不改写用户配置：
+
+```yaml
+memory_superpowers:
+  memory_path: docs/memory
+  documents:
+    standards: [CONTRIBUTING.md, docs/frontend]
+    product: [existing/prd.md]
+    api: [https://example.com/openapi.yaml]
+    design: [design/checkout.md]
+    prototype: [https://example.com/prototype/checkout]
+```
+
+未配置类别可省略；路径相对仓库，文档入口可多目录、单文件或 URL。保留原位置，AI 按任务读取原文；适用规范必须读取，不能赌语义搜索命中。Memory 路径必须位于项目内。已注册后改变路径会报错，需先迁移 Basic Memory 项目注册，避免静默指向错误目录。
+
+## 研发需求评审（按需）
+
+安装角色会分发 `review-requirements` 技能。对 AI 说“用 review-requirements 核对这份产品需求和原型，检查闭环及接口支撑能力”即可触发。它可以独立使用，不要求先初始化 Basic Memory；后续实现仍由 Superpowers 负责。
+
+该入口复用 BMAD **6.12.4 的 PRD Validate**，补充研发视角的审查标准：流程与状态、权限与交互、字段与接口、异常恢复、资料一致性、可验收结果。需要实际读取原型/设计，缺失或不可访问的内容明确标为未核实。设计稿优先作为视觉依据；产品与原型的业务冲突需确认。输出含具体出处、触发场景、实施影响和待产品确认的问题，默认保留原件。
+
+```sh
+# 仅安装固定版本依赖，不执行评审
+uv run <review-requirements>/scripts/bmad.py install --project /absolute/project
+
+# 准备评审绑定；后续由 AI 按 SKILL.md 实际阅读、审查和生成报告
+uv run <review-requirements>/scripts/bmad.py prepare --project /absolute/project \
+  --prd 'docs/product/订单需求.md' --task '.airules/tasks/order-review'
+```
+
+`<review-requirements>` 为安装输出中的该技能目录。脚本需要 uv、Git 和 Python 3.12（uv 可管理）。`--prd` 接受仓库内 UTF-8 文本文件，名称不必是 `prd.md`；PDF、Word 或远程主文档须由宿主工具读取/导出原文并保留出处。原型、API 等入口仍可配置为 URL。复用上述 `memory_superpowers.documents` 配置；自定义配置传入相同的 `--config`，该评审脚本要求配置文件位于项目内。
+
+BMAD 原始文件从固定 commit `bab9082c3e884e0d72c759bcd1a6d90bcc01be84` 获取。依赖和隔离运行目录位于忽略的 `.airules/memory-superpowers/`，不接管项目已有 `_bmad`、宿主 MCP、规则或 hooks。`install`/`prepare` 不安装全套 BMM、不执行 PRD 创建/更新；这种必要组件分发是 AIRules 适配，并非官方单技能安装命令。已有缓存或运行文件发生冲突时保留并报错，不自动重置。
+
+准备脚本输出路径绑定 JSON，复用任务 `sources.jsonl`（仅 `file`、`reason`），并只自动加入明确指定且已读取的 PRD。AI 实际采用其他依据后再补索引。准备成功不代表评审通过：AI 需执行上游工作流并生成任务目录内的 `review-rubric.md`、`validation-report.md` 和 `.html`。重复评审只综合本轮重新生成的 reviewer 文件，避免旧问题混入。内层 headless 把未决事项记录下来，外层 AI 必须向用户抛出重要问题。报告完成与需求可实施性分别判断。
+
+本次只支持 Validate 依赖链；需要完整产品文档创建/更新时另行使用完整 BMAD。角色安装/脚本验证与实际评审演练的范围见 [验证记录](VERIFICATION.md)。上游来源：[PRD 技能](https://github.com/bmad-code-org/BMAD-METHOD/tree/v6.12.4/src/bmm-skills/plan/bmad-prd)、[headless 输入协议](https://github.com/bmad-code-org/BMAD-METHOD/blob/v6.12.4/src/bmm-skills/plan/bmad-prd/references/headless.md)。
+
+## 使用
+
+项目规则入口读取本地 policy：按需求确定性、行为影响、兼容性和验证难度分流。只读/文案略过完整流水线；明确局部修改直接实现并验证；Bug 使用 systematic-debugging 和有意义的复现/回归；新功能按缺口使用 brainstorming/计划/执行；高影响变更补全设计/评审/验证。影响扩大时说明并升级。显式指定技能或完整流程优先。项目政策明确覆盖上游默认全流程触发，保留原始官方技能。所有任务保留验收条件，完成声明依赖真实检查结果；强制合并条件继续由已有 CI 实施。
+
+正式文档是规范/需求/接口/设计的权威；sources.jsonl 是本任务实际采用依据的 file + reason 索引；Memory 保存可复用经验和权威引用，不维护第二套正式文档。陌生术语、相似故障、相关模块修改、重要决策时检索并核对代码和原文。写前检索、优先更新、标明依据和适用范围；没有新经验就无需笔记。
+
+```sh
+uv run <skill>/scripts/project.py source --project /project existing/task-dir docs/product/order.md '订单状态依据'
+uv run <skill>/scripts/project.py bm --project /project tool search '订单' --local
+uv run <skill>/scripts/project.py bm --project /project tool write --identifier lessons/order.md --content '# 经验及验证依据' --local
+```
+
+source 命令按 file 去重更新。没有任务系统时使用 `.airules/tasks/<任务标识>`；索引随恢复、实施、评审和获授权的子代理传递，读取职责相关原文。轻微修改不强制计划/设计。结束前对照原文验收并处理冲突/变化/不可访问资料。
+
+## 团队与维护
+
+将 docs/memory Markdown 和正式资料、任务索引按项目流程提交；写笔记不自动 commit/push。`.airules/memory-superpowers/` 是忽略的机器状态（配置、数据库、索引、上游检出），每个 clone/worktree 依据真实绝对路径产生独立项目名。团队 clone/pull 后安装 role 并执行 init（再次执行会 index），从共享 Markdown 建立/更新自己的索引。MCP 固定项目，不使用全局默认项目。不可用时直接读 Markdown 并报告检索降级。
+
+卸载 AIRules role 不触碰项目资料。手工移除该 role 的项目 MCP 条目、AGENTS/CLAUDE 标记块、生成的技能链接及忽略的本地状态即可取消项目接入；保留 Memory、正式文档和 sources。不要删除复用的全局技能。
+
+上游核对于 2026-11-02：Basic Memory 运行包 1.0.0；官方 skills commit `01b43f9753f1d8422645e7426e7d55ef3efba179`；Superpowers 7.0.1 commit `2ce8aa15d05bd57213e6f746f953aafb7ded7a8b`。官方支持共享 SKILL.md 接入，本角色采用该方式，避免重复插件注入。来源：[Basic Memory](https://github.com/basicmachines-co/basic-memory)、[Superpowers](https://github.com/obra/superpowers)。升级时更新 project.py 中依赖和 commit，重新跑角色测试与临时项目集成测试，再提高 role_version；不会自动追踪 latest。
+
+验证边界详见 [验证记录](VERIFICATION.md)。规则分流是 AI 指令，不能将文件存在视为模型实际行为保证。

package/roles/memory-superpowers/role.yaml

@@ -0,0 +1,26 @@
+schema_version: 2
+role_id: memory-superpowers
+role_version: 0.2.0
+status: experimental
+canonical_root: roles/memory-superpowers
+description: Local Basic Memory, official Superpowers, and on-demand BMAD requirements review with shared task sources.
+extends_roles: []
+provides:
+  capabilities: []
+installation:
+  hosts: [claude, codex, cursor]
+  assets:
+    skills: skills
+  role_vendor:
+    name: memory-superpowers-role
+    source: https://github.com/moluoxixi/AIRules.git
+    projections:
+      - kind: role-assets
+        source_dir: roles/memory-superpowers
+  distribution:
+    bootstrap_manifest: role.yaml
+    full_role_path_required: true
+    npm_embedded_source: false
+  entrypoints:
+    initialize_project_skill: memory-superpowers
+    initialize_project_script: skills/memory-superpowers/scripts/project.py