企业官网建设流程全解析

Compatibility

【免费下载链接】ruflo🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo

• CLI:pinned to@claude-flow/cliv3.6 major+minor.
• Verification:bash plugins/ruflo-adr/scripts/smoke.shis the contract.

Namespace coordination

This plugin owns theadr-patternsAgentDB namespace. It defers to ruflo-agentdb ADR-0001 §"Namespace convention" for naming rules. Reserved namespaces (pattern,claude-memories,default) MUST NOT be shadowed.

其中 `adr-patterns` 遵循 kebab-case 的 `<plugin-stem>-<intent>` 命名规则，并被用于 ADR 语义搜索以及跨项目模式迁移（经 `ruflo-intelligence` 的 `hooks_transfer`）。 ### 3. 插件元数据升级 [.claude-plugin/plugin.json](https://link.gitcode.com/i/6c4b0b0a835272348852d7ef6875abe0) 由 `0.1.1 → 0.2.0`，新增关键词 `lifecycle`、`compliance`、`causal-graph`、`mcp`，description 重新表述 AgentDB 图谱支撑。值得注意的是，仓库当前状态该文件已演进到 `0.4.1`，关键词数组完整保留了契约要求的四个词，并追加了 `ruflo`、`adr`、`architecture`、`decisions`、`documentation`： ```json { "name": "ruflo-adr", "description": "ADR lifecycle management — create, index, reconcile, supersede, check compliance, and link Architecture Decision Records to code via AgentDB hierarchical store + causal edges (supersedes/amends/depends-on/related)", "version": "0.4.1", "license": "MIT", "keywords": ["ruflo", "adr", "architecture", "decisions", "documentation", "lifecycle", "compliance", "causal-graph", "mcp"] }

4. smoke 脚本即契约（Smoke as Contract）

scripts/smoke.sh在 ADR-0001 成文时定义了10 项检查，把上一节的全部承诺翻译为可执行断言：

1. plugin.json声明0.2.0且包含新关键词；
2. 3 个技能（adr-create、adr-index、adr-review）全部存在，且 frontmatter 含name、description、allowed-tools；
3. commands/adr.md 覆盖全部 7 个子命令（create | list | status | supersede | check | graph | search）；
4. Agent 引用REFERENCE.md（ADR-098 Part 2 的 token-optimization 模式）；
5. Agent 与技能一致使用adr-patterns命名空间；
6. README 含 Compatibility 章节并 pin 到@claude-flow/cliv3.6；
7. README 含 Namespace coordination 章节并服从ruflo-agentdbADR-0001；
8. ADR 文件存在且状态为Proposed；
9. REFERENCE.md存在且非空；
10. 没有任何技能授予通配符工具权限（allowed-tools: *被禁止）。

当前仓库中的 scripts/smoke.sh 头部注释写着Structural smoke test for ruflo-adr v0.4.1 (ADR-0001, ADR-0002)，检查项已从 10 项扩展为22 项——ADR-0001 建立契约骨架后，ADR-0002（删除 ADR 的 reconcile）在其上追加了脚本可执行性、共享解析库、reindex.mjs后置条件、cwd传递等行为级断言。这正是"smoke 即契约"模式的自我演进证据：契约不是静态文档，而是随决策持续生长的断言集。

5. Agent 文件：保留既有命名空间契约，不删减任何内容

agents/adr-architect.md 已经写入adr-patterns（符合命名空间约定的 kebab-case 形式），因此除 README 中的命名空间协调交叉引用外，Agent 文件无需改动。当前 Agent 契约中的内存操作片段：

npx @claude-flow/cli@latest memory store --namespace adr-patterns --key "decision-CATEGORY" --value "CONTEXT_AND_OUTCOME" npx @claude-flow/cli@latest memory search --query "architectural decision" --namespace adr-patterns

三、契约落地：从文档到可执行命令与参考数据

7 子命令分发器与 AgentDB 图存储

commands/adr.md 是契约第 3 条检查的对象，它把$ARGUMENTS解析为 7 条子命令，其中生命周期类命令直接依赖 AgentDB 的 MCP 工具：

关系词表在 REFERENCE.md 中给出标准语义：supersedes（取代旧 ADR）、amends（调整但旧 ADR 保持accepted）、depends-on（正确性依赖另一 ADR 的决策仍生效），以及related。图存储的调用形态可直接复用：

mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-store \ --key "mem:ADR-097" --tier "semantic" \ --value '{"status":"accepted","title":"...","date":"2026-05-04"}' mcp__plugin_ruflo-core_ruflo__agentdb_causal-edge \ --sourceId "mem:ADR-097" --targetId "mem:ADR-086" --relation "depends-on"

REFERENCE.md 与 token-diet 模式

ADR-0001 的第 4 条检查要求 Agent 引用REFERENCE.md，其动机是 REFERENCE.md 开篇所述：Agent prompt 按 ADR-098 Part 2 刻意保持精简，把模板、图存储配方、违规检测工作流放进按需读取的参考文件——据 Agent 文件记载，这样每次 spawn 可节省约 40% 的 token。参考文件承载的内容包括：完整 ADR Markdown 模板、生命周期状态机、AgentDB 分层存储与因果边命令、代码-ADR 违规检测四步法（GrepADR 引用 →git blame定位变更 → 对比 ADR 状态时间戳 → 输出结构化发现），以及docs/adr/README.md平面索引的维护规则。

四、影响评估（Consequences）

ADR-0001 对决策后果做了诚实的三分法：

• 积极：插件加入本会话所有插件遵循的同一契约——pin → ADR → smoke → 命名空间协调；adr-patterns命名空间从此被契约性归属本插件（任何其他写入者都收到"notice"）；子命令覆盖与技能清单的漂移可以在 CI 中被捕获。
• 消极：0.1.1 → 0.2.0是一次 minor 跳升，理由是新契约而非行为变更。
• 中性：不新增 MCP 工具、不新增技能、不新增命令，仅文档与 smoke。

五、验证方式与 CI 集成

契约的验证入口单一且可脚本化：

bash plugins/ruflo-adr/scripts/smoke.sh # ADR-0001 成文时期望：10 passed, 0 failed # 当前仓库（0.4.1，含 ADR-0002 追加检查）期望：22 passed, 0 failed

【免费下载链接】ruflo🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo