配置作用域审计：Python 服务

Instruction Hierarchy（指令层级）

根指南包含用途、结构、规范命令、安全边界和链接。API、迁移和文档指引仍保持在路径作用域。

Path Rule Fixtures（路径 Rule Fixture）

API allow fixture src/api/orders.py 会加载合约和 authorization 指引；deny fixture docs/orders.md 不会。迁移 fixture 证明只追加指引仅在 migrations/** 下加载。

Skill and Command（Skill 与 Command）

migration-review Skill 打包可复用的证据收集流程。旧的显式 ADR command 仍然兼容，但新的多步骤流程使用 Skill，让辅助文件按需加载。两者都不授予 authorization。

Skill Package（Skill 包）

migration-review-skill/SKILL.md 定义触发 description 和狭窄的 allowed-tools 授权。它将详细证据路由到 references/review-checklist.md，并用 scripts/check_scope.py 校验每个参数。该授权只为调用回合预批准随附检查器，不限制其它所有 tool，也不覆盖 deny Rule。

Subagent Contract（Subagent 合约）

/agents 注册一个具有 read-only tool、maxTurns: 10，并在请求编辑时使用 isolation: worktree 的迁移审计器。它的响应包含 status、evidence、blockers 和 next_step。它会在回合上限处停止并报告障碍，而不会声称成功或扩大范围。

Plugin Distribution（Plugin 分发）

项目 Skill 和 agent 提交在 .claude/ 下。共享 plugin 来源和默认值通过 .claude/settings.json 中的 extraKnownMarketplaces 与 enabledPlugins 管理，并配套文件夹信任和审查。组织的 managed settings 限制允许的 marketplace 和不可妥协的权限；上线前记录版本和回滚方案。

Hooks（Hook）

确定性的 pre-write hook 阻止声明作用域外的路径；post-edit hook 只格式化变更文件；pre-command hook 阻止打印 secret 和破坏性操作。PreToolUse 结构化决定使用 exit 0 和 JSON；exit 2 hook 将阻止原因写入 stderr，不打印 JSON。PermissionRequest hook 使用它自己的嵌套决定形态。

Headless CI（无头 CI）

CI 从 fresh checkout 开始，使用版本化项目配置、read-only 审查 tool、受限运行时、structured finding 和独立的 deterministic 测试。它绝不继承交互式 session。核验于 2026-08-09，managed Code Review 是 Team 和 Enterprise 的 research preview；它报告 finding，但不替代 gate。仓库自动化使用 anthropics/claude-code-action@v1，并明确声明 workflow 权限和 tool。

Remediation（修复）

稳定 finding ID、原始证据、当前 diff、测试和验收 Rule 会传给修复审查；个人本地偏好不在其中。