Claude Code Constraints — AI skill for Claude Code

Claude Code 7-Layer Constraints

让 Claude Code 从随机走向可控的长期协作约束系统

什么是 7 层约束

短任务里，Agent 的问题通常很隐蔽。代码能生成，页面能运行，大部分结果看起来没有明显错误。

工作流一旦进入长期阶段，问题会开始集中出现：build 被跳过、文件只读一半、工具失败后继续输出、未验证状态被压缩成"应该正常"、长上下文污染当前任务……

这套系统把约束从 prompt 层面提升到系统层面，形成七层结构：

层级	名称	解决什么问题	核心机制
1	Hook	输入端硬约束注入	UserPromptSubmit 事件注入纪律框
2	Skill	一次性提示变持续性协议	Superpowers 插件自动加载
3	CLAUDE.md	按范围分级的规范体系	个人层 → Workspace 层 → 项目层
4	Quality	交付前审计标准	冷却审查 + 9维度设计审计
5	Discipline	关键决策点行为补丁	障碍排查、完成验证、积压扫描
6	Scripts	约束的自动化执行器	前端审计、归档、日报
7	Memory	跨会话持续反馈	违规记录、行为修正、档案维护

每一层都对应一种行为退化。不是"让 AI 记得遵守"，而是"让它不得不遵守"。

快速开始（5 分钟）

1. 克隆仓库

git clone https://github.com//claude-code-constraints.git
cd claude-code-constraints

2. 复制 Hook 配置

cp templates/settings.json ~/.claude/settings.json

编辑 `~/.claude/settings.json`，将脚本路径改为你本机的实际路径。

3. 复制个人规范

cp templates/CLAUDE.md ~/.claude/CLAUDE.md

按需修改：

• "关于我"部分改成你的身份和偏好
• 项目注册表路径改成你的实际路径
• 文件夹映射改成你的项目结构

4. 安装纪律 Hook

cp scripts/hook-discipline.js ~/.claude/scripts/
cp scripts/hook-cwd-check.js ~/.claude/scripts/

5. 启用 superpowers 插件

在 `~/.claude/settings.json` 中添加：

{
  "enabledPlugins": {
    "superpowers@claude-plugins-official": true
  }
}

完成。下次启动 Claude Code 时，约束系统开始生效。

可选增强

前端审计（推荐）

cp scripts/audit-html.js ~/.claude/scripts/

在 `~/.claude/CLAUDE.md` 中加入：

## 前端文件 Write/Edit 后强制审计

任何对 `.html` `.css` `.js` 文件的 Write 或 Edit 操作后：
1. **立即执行**：`node ~/.claude/scripts/audit-html.js [目标目录]`
2. **阻断规则**：audit 未通过 → **禁止声明完成** → 立即修正 → 重新 audit

会话归档与日报

cp scripts/archive-*.js ~/.claude/scripts/
cp scripts/daily-digest-*.j