架构决策辩证
每份 ADR 强制列备选方案表 + 排除原因 + 反转条件。docs/adr/_template.md · 已应用 6 份
对照 guide-general v2.0
——五层能力金字塔 × 四级渐进治理模型,对账当前项目命中了哪些、缺什么、下一步补什么。
ADR-007 已落地:MCP(context7 + firecrawl)+ 显式 Team(three-layer-review)+ fact-checker §6 外部真值交叉验证(firecrawl / WebSearch ≥ 1 处外部来源)。 不再引入独立 LLM 交叉审查 —— 自媒体核查的真值在外部网页,不在另一个 LLM。
越往下越稳定、越通用;越往上越灵活、越专业。当前项目重心落在 L1-L2,L3 通过自建 8 个 agent 形成"伪 L3"。
superpowers 社区 SKILL (13+) · 第三方 Plugin
官方 SKILL (16 个) · 官方 Plugin 市场 (33+)
Agent tool · Agent Team · Skill tool · 外部真值锚定
Hooks (6 事件) · 自定义 Agent · MCP 服务器
CLAUDE.md · AGENTS.md · rules/ · Plan · think · /compact · memory
不需要安装任何插件,每次对话自动生效。
| 层级 | 能力 | 状态 | 本项目落点 |
|---|---|---|---|
| L1 | CLAUDE.md 项目级 governance,每次会话自动加载 |
● HIT | CLAUDE.md · 159 行 |
| L1 | AGENTS.md 跨工具 (Cursor/Windsurf/Codex) 标准化 |
● HIT | AGENTS.md |
| L1 | .claude/rules/ 路径级规则 frontmatter paths 字段,编辑特定路径自动加载 |
● HIT | 7 份 rules |
| L1 | Plan 模式 Shift+Tab×2 触发,先对齐再动手 |
● HIT | autopilot SKILL 默认使用 |
| L1 | think / ultrathink 触发扩展推理,架构决策必用 |
● HIT | 按需触发 |
| L1 | /compact /clear 上下文管理,60% 时压缩 |
● HIT | 内置 |
| L1 | memory/ 跨 session 记忆 user / feedback / project / reference 四类 |
◑ PARTIAL | ~/.claude · 隐式 |
通过几份配置文件,把"隐性约定"显式化、机器可强制。
| 层级 | 能力 | 状态 | 本项目落点 |
|---|---|---|---|
| L2 | Hooks · 6 事件自动化 PreToolUse / PostToolUse / Stop / SessionStart 等 |
● HIT | .claude/settings.json |
| L2 | 自定义 Agent .claude/agents/*.md,frontmatter 定义能力边界 |
● HIT · 8 个 | editor / style-auditor / fact-checker / scorer / scout / architect / visual-designer / distributor |
| L2 | CONSTITUTION.md · 红线 不可违反的架构护栏 |
● HIT | CONSTITUTION.md · 6 条红线 |
| L2 | ADR · 架构决策记录 追加不删除,废弃打标 |
● HIT · 6 份 | docs/adr/ADR-001 → ADR-006 |
| L2 | MCP 服务器 扩展工具集,context7(文档查询)+ firecrawl(资讯抓取) |
● HIT | .mcp.json · ADR-007 |
| L2 | SKILL · 项目级 .claude/skills/,封装复杂工作流 |
● HIT | wechat-autopilot/SKILL.md |
多 Agent 并行 + 外部 Plugin 交叉审查 + 社区 SKILL 流程标准化。
| 层级 | 能力 | 状态 | 本项目落点 |
|---|---|---|---|
| L3 | Agent tool · Sub Agent 隔离上下文,把探索委派出去 |
● HIT | autopilot 内频繁调度 |
| L3 | Agent Team · 并行编排 对抗性审计、信息隔离协议显式化 |
● HIT | .claude/teams/three-layer-review.md |
| L3 | code-review Plugin 官方代码审查自动化 |
— N/A | 非代码项目,等效物 = scorer agent |
| L3 | 外部真值交叉验证(firecrawl / WebSearch) 替代独立 LLM 交叉审查 —— 真值在外部网页,不在另一个 LLM |
● HIT | fact-checker.md §6 · ADR-007 §3 |
| L3 | ralph-loop Plugin 闭环开发,verification-before-completion |
— N/A | 已有 publish-checker + 视觉退出条件 |
| L3 | 社区 SKILL · superpowers writing-plans / TDD / verification 等 |
✕ MISS | 可借鉴 writing-plans 给立纲阶段 |
| L3 | CI 集成 GitHub Actions / 自动化检查 |
— N/A | 非代码项目,但可加 frontmatter lint |
三步全部落地。第三步从「独立 LLM 交叉审查」校准为「外部真值锚定」—— 真值在外部网页,不在另一个 LLM。
新建 .mcp.json,集成 context7(文档查询)+ firecrawl(行业资讯抓取,反哺 scout)。firecrawl 需配 FIRECRAWL_API_KEY 环境变量。
.mcp.json
editor / style-auditor / fact-checker 三 agent 并行调度,信息隔离协议固化,失败循环上限 3 轮。autopilot REVIEW 阶段直接 invoke team。
.claude/teams/three-layer-review.md
fact-checker §6 新增强制规则:关键事实必须用 firecrawl 或 WebSearch 找到 ≥ 1 处独立外部来源。不引入 OpenAI 依赖 —— 真值在外部网页,不在另一个 LLM。
fact-checker.md §6
通用指南 §8 列了三种结构化反思方法。当前项目对应实现:
每份 ADR 强制列备选方案表 + 排除原因 + 反转条件。docs/adr/_template.md · 已应用 6 份
style-auditor 强制以"读者第一次看到"的视角扫雷区,editor 强制"对创业者有没有用"的产品视角。
关键事实:fact-checker 内部素材自洽 + firecrawl/WebSearch 外部真值锚定 + 复盘 7 天数据回收,三方对账。
通用指南 §7:上下文窗口超过 60% 表现明显下降。当前项目的执行策略:
| 预算 | 用于 | 本项目执行 |
|---|---|---|
| 20% | 系统 prompt + CLAUDE.md + rules | CLAUDE.md 159 行 + 7 rules 按 paths 延迟加载 |
| 30% | 当前任务对话与代码 | autopilot 七阶段分段,单段不超过 30 轮 |
| 10% | 工具调用结果 | 素材搜索委派给 scout agent(隔离上下文) |
| 40% | 空闲(安全余量) | 每 CP 节点提示 /compact 或开新 session |