[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EFCPVTEHHTZF1559AV9F4N":3,"skill-same:01M7EFCPVTEHHTZF1559AV9F4N":61},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":41,"commitSha":42,"skillDirectory":43,"forksCount":44,"repositoryHtmlUrl":45,"repositoryHomepageUrl":6,"ownerHtmlUrl":46,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":47,"install":48,"resources":60},"01M7EFCPVTEHHTZF1559AV9F4N","setup-arthurpower",null,"Use when bootstrapping an Arthurpower project for the first time, migrating an existing repo onto Arthurpower (preserving prior content), gap-filling against a partial setup, or switching a multi-context project to CONTEXT-MAP.md mode. User-invoked: operator triggers explicitly; model does NOT auto-fire. Registers 5 context-闭环 hooks + pre-fs-guard WITH dedup detection.","winter6205\u002Farthurpower","winter6205","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F136674824?v=4","01M7EF9EWNYDKHX9MR3AG5QV7A","01M7EF9EXCC1CNFXQNV6PS3M8B",2,"MIT","https:\u002F\u002Fgithub.com\u002Fwinter6205\u002Farthurpower\u002Fblob\u002Fmaster\u002Farthurpower\u002Fskills\u002Fsetup-arthurpower\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: setup-arthurpower\ndescription: \"Use when bootstrapping an Arthurpower project for the first time, migrating an existing repo onto Arthurpower (preserving prior content), gap-filling against a partial setup, or switching a multi-context project to CONTEXT-MAP.md mode. User-invoked: operator triggers explicitly; model does NOT auto-fire. Registers 5 context-闭环 hooks + pre-fs-guard WITH dedup detection.\"\nbucket: engineering\ndisable-model-invocation: true\nversion: 3.0.0\ntags:\n  [\n    Setup,\n    Bootstrap,\n    ContextMap,\n    Contract,\n    OneShot,\n    Hooks,\n    Dedupe,\n    Migration,\n    GithubPull,\n  ]\nauthor: Arthurpower\nrelated_skills: [domain-modeling, logicsync, self-evolving-rules]\n---\n\n# Setup Arthurpower - 结构声明入口 (一次性)\n\n> **User-invoked skill.** This skill is NOT auto-triggered by description match\n> (`disable-model-invocation: true`). The operator must explicitly run it. A\n> one-shot setup entry should not fire mid-task - that re-bootstraps already-\n> initialized projects. This was previously a slash command; it is now a\n> user-invoked skill so the frontmatter shape matches the rest of the plugin\n> (skill, not command) while keeping the explicit-invocation discipline.\n\n## Overview\n\n初始化钩子, 在项目首次接入或迁移时运行一次. 它不写业务术语, 只声明**结构**: 在哪里读 \u002F 在哪里写 \u002F 谁消费.\n\n**核心承诺**:\n\n- **双模式适配**: 自动检测 fresh (无 `CLAUDE.md`) \u002F old-repo (已有 `CLAUDE.md` 等) \u002F intermediate, 跑对应流程\n- **不删旧内容**: 旧仓库接入时, 只补缺的 (`.claude\u002Frules\u002F` `.claude\u002Fhooks\u002F` `.claude\u002Fskills\u002F` `docs\u002FCONTEXT.md` `scripts\u002F` `.evals\u002F`), 不动 `CLAUDE.md` \u002F `CLAUDE.local.md` \u002F 已有 `docs\u002F` 内容\n- **GitHub pull**: 默认模板源 = `\u003Cowner>\u002F\u003Crepo>` GitHub 仓, 通过 `scripts\u002Fupdate.sh --from-git` 拉取\n- **5 hook dedup**: 默认注册 5 个 context-闭环 hook + pre-fs-guard, 按用户级是否已有同名 hook 三分支决策 (干净 \u002F 部分重叠 \u002F 全重叠)\n\n## When to Use\n\n- 新项目首次接入 Arthurpower\n- 现有项目迁移到 Arthurpower 规范 (保留旧内容)\n- 项目已有部分 Arthurpower 资产但缺关键部件, 增量补齐\n- 多语境项目需要切换为 `CONTEXT-MAP.md` 模式\n\n## When NOT to Use\n\n- 已完整初始化过 (检查 `docs\u002Fagents\u002Fcontext-contract.md` + `.claude\u002Fskills\u002Fdomain-modeling\u002F` + `.evals\u002Frun.sh` 三个全有)\n- 只想补 glossary 词 -> 走 `domain-modeling`\n- 只想访谈对齐术语 -> 走 `logicsync`\n\n## How to Run\n\n### Step 0: Mode Detection\n\n读项目根, 判断 3 种模式:\n\n| 检测条件                                           | 模式             | 后续流程                                                                |\n| -------------------------------------------------- | ---------------- | ----------------------------------------------------------------------- |\n| 无 `CLAUDE.md` 且无 `.claude\u002F`                     | **fresh**        | Step 1 -> Step 6 (GitHub pull bootstrap) -> Step 1-5                    |\n| 有 `CLAUDE.md` (或 `docs\u002FCONTEXT.md` \u002F `.claude\u002F`) | **old-repo**     | Step 1-4 skip \u002F 已有则保留 -> Step 5 dedup 注册 -> Step 6 update (可选) |\n| 部分有 (有 `CLAUDE.md` 但缺 `.claude\u002Frules\u002F` 等)   | **intermediate** | Step 0.5 gap-fill -> Step 5 dedup -> Step 6 update (可选)               |\n\n**判断依据不要靠文件清单**: 任意一个核心标记文件 (`CLAUDE.md` \u002F `docs\u002FCONTEXT.md` \u002F `.claude\u002Fsettings.json`) 存在 -> 视为 old-repo 或 intermediate, 绝不删旧文件.\n\n### Step 0.5: Gap-Fill (intermediate 模式专用)\n\n对 old-repo \u002F intermediate, 列出已有 vs 缺, 只补缺:\n\n```bash\ndeclare -a REQUIRED=(\n  \"docs\u002Frules\u002Fcontext-loop.md\"\n  \".claude\u002Fhooks\u002Fpre-context-write-guard.cjs\"\n  \".claude\u002Fhooks\u002Fpre-stale-read.cjs\"\n  \".claude\u002Fhooks\u002Fpre-read-contract.cjs\"\n  \".claude\u002Fhooks\u002Fpost-ssot-priority.cjs\"\n  \".claude\u002Fhooks\u002Fpost-conflict-annotation.cjs\"\n  \".claude\u002Fhooks\u002Fpre-fs-guard.cjs\"\n  \".claude\u002Fskills\u002Fdomain-modeling\u002FSKILL.md\"\n  \"docs\u002FCONTEXT.md\"\n  \"docs\u002Fagents\u002Fcontext-contract.md\"\n  \"scripts\u002Fbootstrap.sh\"\n  \"scripts\u002Fupdate.sh\"\n  \".evals\u002Frun.sh\"\n)\nfor f in \"${REQUIRED[@]}\"; do\n  if [ ! -f \"$f\" ]; then\n    echo \"[gap-fill] MISSING: $f (will pull from template)\"\n    PULL_LIST+=(\"$f\")\n  fi\ndone\n```\n\n非空 PULL_LIST 调 `scripts\u002Fupdate.sh --from-git \u003Cowner>\u002F\u003Crepo> --only \"${PULL_LIST[@]}\"` (update.sh Step 5b 增量).\n\n**PROTECTED 永不覆盖** (即使 `--force`): `CLAUDE.md`, `CLAUDE.local.md`, `docs\u002FCONTEXT.md`, `.claude\u002Fsettings.local.json`, `.claude\u002Fsettings.json`, `docs\u002Fhandoff\u002F*`.\n\n### Step 1: 探测项目语境\n\n```\n问用户 (或从 package.json \u002F Cargo.toml \u002F pyproject.toml 推断):\n  - 单仓单语境 (默认) -> CONTEXT.md\n  - 单仓多语境 (monorepo) -> CONTEXT-MAP.md + 各 \u003Cctx>\u002Fdocs\u002FCONTEXT.md\n```\n\n### Step 2: 创建目录\n\n```bash\nmkdir -p docs\u002Fagents docs\u002Fadr\n# monorepo: mkdir -p src\u002F\u003Cctx>\u002Fdocs\u002FCONTEXT.md (Step 5b 决策为干净环境后)\n```\n\n### Step 3: 写入 context-contract.md\n\n复制模板版 `docs\u002Fagents\u002Fcontext-contract.md` 到项目根.\n\n### Step 4: 写入占位 CONTEXT.md 或 CONTEXT-MAP.md\n\n单语境占位 (H1 标题用 operator decide 的项目名, **不要事后通过 Edit 改 H1**, 那会被 pre-context-write-guard 拦截):\n\n```markdown\n# \u003C项目名> - 领域词汇表\n\n> 本文件是项目领域词汇的**单一事实源 (SSOT)**.\n> 仅 `domain-modeling` 技能可写; 其他技能按 `docs\u002Fagents\u002Fcontext-contract.md` 消费.\n\n---\n\n## Language\n\n\u003C!-- domain-modeling 会逐词添加 -->\n\n---\n\n## Flagged ambiguities\n\n\u003C!-- domain-modeling 会记录 -->\n```\n\n多语境:\n\n```markdown\n# CONTEXT Map\n\n| Context | Path                        | Owner   |\n| ------- | --------------------------- | ------- |\n| \u003Cctx-1> | src\u002F\u003Cctx-1>\u002Fdocs\u002FCONTEXT.md | @\u003Cteam> |\n```\n\n### Step 5: 注册物理护栏 (按需, 避免双重)\n\n**核心原则**: Claude Code 的 hook 是从用户级 + 项目级**叠加收集**而非 fallback, 同 matcher 重复注册会跑两次 (产生 systemMessage 重复 + state 文件读写竞态). 所以 hook 注册必须按环境分支.\n\n**Step 5a: 探测用户级是否已注册**\n\n读取 `~\u002F.claude\u002Fsettings.json` 的 `hooks.PreToolUse` + `PostToolUse` 列表, 看是否含同名 hook 文件名. 默认检测 6 个 hook (5 context-闭环 + pre-fs-guard):\n\n| Hook                           | 触发                                                     | 职责                                                                     |\n| ------------------------------ | -------------------------------------------------------- | ------------------------------------------------------------------------ |\n| `pre-context-write-guard.cjs`  | PreToolUse Write\u002FEdit\u002FMultiEdit\u002FBash                     | CONTEXT.md \u002F ADR 写入主权 + Bash 3-regex                                 |\n| `pre-stale-read.cjs`           | PreToolUse Write\u002FEdit\u002FMultiEdit\u002FBash (src\u002F)              | CONTEXT.md mtime 过期 -> advisory                                        |\n| `pre-read-contract.cjs`        | PreToolUse Write\u002FEdit\u002FMultiEdit\u002FNotebookEdit\u002FBash (src\u002F) | 写 src\u002F 前未读 CONTEXT.md -> advisory                                    |\n| `post-ssot-priority.cjs`       | PostToolUse Write\u002FEdit\u002FMultiEdit\u002FBash                    | team\u002Fproject\u002Fsub-context 术语冲突 -> stderr POST-FIX WARNING             |\n| `post-conflict-annotation.cjs` | PostToolUse Write\u002FEdit\u002FMultiEdit\u002FBash (tool_name 白名单) | skill 输出矛盾 ADR -> advisory                                           |\n| `pre-fs-guard.cjs`             | PreToolUse Bash                                          | 拦 `find \u002F` \u002F `grep -r \u002F` \u002F 尾随 `&` (2026-07 find.exe handle leak 防护) |\n\n**Step 5b: 三种决策**\n\n| 场景                    | 判定                            | 动作                                       |\n| ----------------------- | ------------------------------- | ------------------------------------------ |\n| 用户级**全无**同名 hook | 干净环境 (CI \u002F Docker \u002F 新机器) | 注册全部 6 hook 到 `.claude\u002Fsettings.json` |\n| 用户级**已有**部分同名  | 部分干净                        | 只注册用户级**没有**的 hook                |\n| 用户级**全有**同名 hook | 与现有用户级环境重叠            | 跳过项目级注册, 提示\"已由用户级提供\"       |\n\n**Step 5c: 项目级注册片段** (只在场景 1+2 才用)\n\n`.claude\u002Fsettings.json` `hooks` 追加:\n\n```json\n\"PreToolUse\": [\n  {\n    \"matcher\": \"Write|Edit|MultiEdit|Bash\",\n    \"hooks\": [\n      {\"type\": \"command\", \"command\": \"node .claude\u002Fhooks\u002Fpre-context-write-guard.cjs\", \"timeout\": 5},\n      {\"type\": \"command\", \"command\": \"node .claude\u002Fhooks\u002Fpre-stale-read.cjs\", \"timeout\": 5},\n      {\"type\": \"command\", \"command\": \"node .claude\u002Fhooks\u002Fpre-read-contract.cjs\", \"timeout\": 5}\n    ]\n  },\n  {\n    \"matcher\": \"Bash\",\n    \"hooks\": [\n      {\"type\": \"command\", \"command\": \"node .claude\u002Fhooks\u002Fpre-fs-guard.cjs\", \"timeout\": 5}\n    ]\n  }\n],\n\"PostToolUse\": [\n  {\n    \"matcher\": \"Write|Edit|MultiEdit|Bash\",\n    \"hooks\": [\n      {\"type\": \"command\", \"command\": \"node .claude\u002Fhooks\u002Fpost-ssot-priority.cjs\", \"timeout\": 5},\n      {\"type\": \"command\", \"command\": \"node .claude\u002Fhooks\u002Fpost-conflict-annotation.cjs\", \"timeout\": 5}\n    ]\n  }\n]\n```\n\n**Step 5d: 字节级操作纪律 (R5)**\n\nsettings.json 含 secret 字段时必须 byte-level (rb + regex + wb). 用 `Edit` 工具精准追加, 不 `Write` 整文件. 改后 `python3 -m json.tool` 校验 JSON 完整.\n\n**Step 5e: 验证**\n\n```bash\nbash .evals\u002Frun.sh --all   # 必须 10\u002F10 (hook 行为正确)\npython3 -c \"import json; print(json.load(open('.claude\u002Fsettings.json'))['hooks'])\"\n```\n\n### Step 6: GitHub Pull (模板规范演进同步)\n\n模板规范演进同步. 默认源 = `\u003Cowner>\u002F\u003Crepo>` GitHub 仓.\n\n```bash\n# 拉取最新模板规范到本项目 (增量, 不覆盖 PROTECTED)\nbash scripts\u002Fupdate.sh --from-git \u003Cowner>\u002F\u003Crepo>\n\n# 仅拉取指定文件 (gap-fill 模式)\nbash scripts\u002Fupdate.sh --from-git \u003Cowner>\u002F\u003Crepo> --only .claude\u002Frules\u002F scripts\u002F\n\n# 本地模板路径 (开发用)\nARTHUR_TEMPLATE=\u002Fpath\u002Fto\u002Flocal\u002Ftemplate bash scripts\u002Fupdate.sh\n\n# 强制覆盖 (会破坏 PROTECTED 之外的本地定制)\nbash scripts\u002Fupdate.sh --from-git \u003Cowner>\u002F\u003Crepo> --force\n```\n\n`update.sh` 自动:\n\n1. `git clone --depth=1 \u003Curl> .template-cache\u002F` (临时目录)\n2. sha256 比对每文件\n3. SAME -> skip \u002F DIFF -> skip (默认) 或 warn `--force` \u002F MISSING -> copy\n4. PROTECTED (`CLAUDE.md`, `CLAUDE.local.md`, `docs\u002FCONTEXT.md`, `.claude\u002Fsettings.json`, `.claude\u002Fsettings.local.json`, `docs\u002Fhandoff\u002F*`) 永不覆盖\n5. 清理临时 clone\n\n## Verification Checklist\n\n### Fresh \u002F Intermediate 模式必查\n\n- [ ] `docs\u002Fagents\u002Fcontext-contract.md` 存在\n- [ ] `docs\u002FCONTEXT.md` 或 `docs\u002FCONTEXT-MAP.md` 存在 (含 SSOT 头注释, H1 标题是正确项目名, **不在 setup 阶段 Edit H1**)\n- [ ] `docs\u002Fadr\u002F` 目录存在 (空目录也 OK)\n- [ ] 6 个 hook 文件存在于 `.claude\u002Fhooks\u002F` (pre-context-write-guard \u002F pre-stale-read \u002F pre-read-contract \u002F post-ssot-priority \u002F post-conflict-annotation \u002F pre-fs-guard)\n- [ ] **hook 注册按需** (Step 5b 三分支)\n- [ ] `domain-modeling` 在 `.claude\u002Fskills\u002F` (模板自带); `logicsync` + `self-evolving-rules` 由 plugin 全局供给 (fresh 模式不必复制到 `.claude\u002Fskills\u002F`, plugin 装上即有)\n- [ ] `docs\u002Frules\u002Fcontext-loop.md` 存在 (post reorg 2026-07-20)\n- [ ] Cross-file \u002F multi-hook changes that can drift **trigger** behavior run `boundary-testing`: **axis1 then axis2** (sequential; axis2 consumes axis1 evals). No standalone rule file; agents under plugin `agents\u002F`.\n- [ ] `arthurpower:self-evolving-rules` skill 可用 (user-invoked, 规则沉淀 6 步流程)\n- [ ] `scripts\u002Fbootstrap.sh` + `scripts\u002Fupdate.sh` 存在 + 可执行\n- [ ] `.evals\u002Frun.sh --all` 10\u002F10 PASS\n\n### Old-repo 模式必查 (增量接入, 不删旧)\n\n- [ ] Step 0 检测正确 (有 CLAUDE.md -> old-repo)\n- [ ] Step 0.5 gap-fill 列出 PULL_LIST, 调 update.sh\n- [ ] **现有 `CLAUDE.md` 未被修改** (sha256 before == sha256 after)\n- [ ] **现有 `docs\u002F` 全部文件未被修改** (除 `docs\u002FCONTEXT.md` 因 gap-fill 创建, `docs\u002Fagents\u002Fcontext-contract.md` 因 gap-fill 创建)\n- [ ] **现有任何文件未删除**\n- [ ] 新增的 hook \u002F rules \u002F skills 通过 update.sh 拉取, sha256 与模板一致\n- [ ] `.claude\u002Fsettings.json` 经 Step 5 dedup 决策后只追加必要的 hook\n- [ ] `.evals\u002Frun.sh --all` 在 old-repo 模式下应至少 5\u002F10 (因旧项目结构可能不符合全部 10 task 假设)\n\n### Setup 完成语义\n\nPASS = fresh 模式跑过 `.evals\u002Frun.sh --all` 10\u002F10 + 6 hook 全在; old-repo 模式现有文件零改动 + 缺的资产通过 update.sh 增量补齐 + dedup 决策正确执行.\n\n## References\n\n- 模板仓: https:\u002F\u002Fgithub.com\u002F\u003Cowner>\u002F\u003Crepo> (含 `scripts\u002Fbootstrap.sh` + `scripts\u002Fupdate.sh`)\n- 读侧契约: `docs\u002Fagents\u002Fcontext-contract.md`\n- 写侧主权: `.claude\u002Fskills\u002Fdomain-modeling\u002FSKILL.md`\n- 物理护栏: `.claude\u002Fhooks\u002Fpre-context-write-guard.cjs` (5 个 context-闭环 hook 的根)\n- 规则层 (always-on): `.claude\u002Frules\u002F{workflow,security-boundaries,git}.md`; 规则层 (on-demand): `docs\u002Frules\u002F{context-loop,task-templates,code-quality,memory}.md` — 见 `workflow.md` 当读\n- Boundary-testing SOP: `boundary-testing` skill — **axis1 then axis2** (sequential). Trigger-semantics only; public-entry input classes → `input-contract-tests`.\n- v3.0.0 changelog: 从 v2.0.0 升级, 新增 Step 0 mode detection + Step 0.5 gap-fill + Step 6 GitHub pull; 集成 pre-fs-guard (v2 漏) + post-ssot-priority \u002F post-conflict-annotation 修复版; Verification Checklist 拆 fresh \u002F old-repo 双分支\n- v3.0.0 -> user-invoked skill 形态: 从 slash command 改回 skill (`disable-model-invocation: true`), 与 plugin 其他 user-invoked skill (architecture-change-reviewer \u002F code-review) frontmatter 形态一致, 保持显式触发纪律\n","# Setup Arthurpower - 结构声明入口 (一次性)\n\n> **User-invoked skill.** This skill is NOT auto-triggered by description match\n> (`disable-model-invocation: true`). The operator must explicitly run it. A\n> one-shot setup entry should not fire mid-task - that re-bootstraps already-\n> initialized projects. This was previously a slash command; it is now a\n> user-invoked skill so the frontmatter shape matches the rest of the plugin\n> (skill, not command) while keeping the explicit-invocation discipline.\n\n## Overview\n\n初始化钩子, 在项目首次接入或迁移时运行一次. 它不写业务术语, 只声明**结构**: 在哪里读 \u002F 在哪里写 \u002F 谁消费.\n\n**核心承诺**:\n\n- **双模式适配**: 自动检测 fresh (无 `CLAUDE.md`) \u002F old-repo (已有 `CLAUDE.md` 等) \u002F intermediate, 跑对应流程\n- **不删旧内容**: 旧仓库接入时, 只补缺的 (`.claude\u002Frules\u002F` `.claude\u002Fhooks\u002F` `.claude\u002Fskills\u002F` `docs\u002FCONTEXT.md` `scripts\u002F` `.evals\u002F`), 不动 `CLAUDE.md` \u002F `CLAUDE.local.md` \u002F 已有 `docs\u002F` 内容\n- **GitHub pull**: 默认模板源 = `\u003Cowner>\u002F\u003Crepo>` GitHub 仓, 通过 `scripts\u002Fupdate.sh --from-git` 拉取\n- **5 hook dedup**: 默认注册 5 个 context-闭环 hook + pre-fs-guard, 按用户级是否已有同名 hook 三分支决策 (干净 \u002F 部分重叠 \u002F 全重叠)\n\n## When to Use\n\n- 新项目首次接入 Arthurpower\n- 现有项目迁移到 Arthurpower 规范 (保留旧内容)\n- 项目已有部分 Arthurpower 资产但缺关键部件, 增量补齐\n- 多语境项目需要切换为 `CONTEXT-MAP.md` 模式\n\n## When NOT to Use\n\n- 已完整初始化过 (检查 `docs\u002Fagents\u002Fcontext-contract.md` + `.claude\u002Fskills\u002Fdomain-modeling\u002F` + `.evals\u002Frun.sh` 三个全有)\n- 只想补 glossary 词 -> 走 `domain-modeling`\n- 只想访谈对齐术语 -> 走 `logicsync`\n\n## How to Run\n\n### Step 0: Mode Detection\n\n读项目根, 判断 3 种模式:\n\n| 检测条件                                           | 模式             | 后续流程                                                                |\n| -------------------------------------------------- | ---------------- | ----------------------------------------------------------------------- |\n| 无 `CLAUDE.md` 且无 `.claude\u002F`                     | **fresh**        | Step 1 -> Step 6 (GitHub pull bootstrap) -> Step 1-5                    |\n| 有 `CLAUDE.md` (或 `docs\u002FCONTEXT.md` \u002F `.claude\u002F`) | **old-repo**     | Step 1-4 skip \u002F 已有则保留 -> Step 5 dedup 注册 -> Step 6 update (可选) |\n| 部分有 (有 `CLAUDE.md` 但缺 `.claude\u002Frules\u002F` 等)   | **intermediate** | Step 0.5 gap-fill -> Step 5 dedup -> Step 6 update (可选)               |\n\n**判断依据不要靠文件清单**: 任意一个核心标记文件 (`CLAUDE.md` \u002F `docs\u002FCONTEXT.md` \u002F `.claude\u002Fsettings.json`) 存在 -> 视为 old-repo 或 intermediate, 绝不删旧文件.\n\n### Step 0.5: Gap-Fill (intermediate 模式专用)\n\n对 old-repo \u002F intermediate, 列出已有 vs 缺, 只补缺:\n\n```bash\ndeclare -a REQUIRED=(\n  \"docs\u002Frules\u002Fcontext-loop.md\"\n  \".claude\u002Fhooks\u002Fpre-context-write-guard.cjs\"\n  \".claude\u002Fhooks\u002Fpre-stale-read.cjs\"\n  \".claude\u002Fhooks\u002Fpre-read-contract.cjs\"\n  \".claude\u002Fhooks\u002Fpost-ssot-priority.cjs\"\n  \".claude\u002Fhooks\u002Fpost-conflict-annotation.cjs\"\n  \".claude\u002Fhooks\u002Fpre-fs-guard.cjs\"\n  \".claude\u002Fskills\u002Fdomain-modeling\u002FSKILL.md\"\n  \"docs\u002FCONTEXT.md\"\n  \"docs\u002Fagents\u002Fcontext-contract.md\"\n  \"scripts\u002Fbootstrap.sh\"\n  \"scripts\u002Fupdate.sh\"\n  \".evals\u002Frun.sh\"\n)\nfor f in \"${REQUIRED[@]}\"; do\n  if [ ! -f \"$f\" ]; then\n    echo \"[gap-fill] MISSING: $f (will pull from template)\"\n    PULL_LIST+=(\"$f\")\n  fi\ndone\n```\n\n非空 PULL_LIST 调 `scripts\u002Fupdate.sh --from-git \u003Cowner>\u002F\u003Crepo> --only \"${PULL_LIST[@]}\"` (update.sh Step 5b 增量).\n\n**PROTECTED 永不覆盖** (即使 `--force`): `CLAUDE.md`, `CLAUDE.local.md`, `docs\u002FCONTEXT.md`, `.claude\u002Fsettings.local.json`, `.claude\u002Fsettings.json`, `docs\u002Fhandoff\u002F*`.\n\n### Step 1: 探测项目语境\n\n```\n问用户 (或从 package.json \u002F Cargo.toml \u002F pyproject.toml 推断):\n  - 单仓单语境 (默认) -> CONTEXT.md\n  - 单仓多语境 (monorepo) -> CONTEXT-MAP.md + 各 \u003Cctx>\u002Fdocs\u002FCONTEXT.md\n```\n\n### Step 2: 创建目录\n\n```bash\nmkdir -p docs\u002Fagents docs\u002Fadr\n# monorepo: mkdir -p src\u002F\u003Cctx>\u002Fdocs\u002FCONTEXT.md (Step 5b 决策为干净环境后)\n```\n\n### Step 3: 写入 context-contract.md\n\n复制模板版 `docs\u002Fagents\u002Fcontext-contract.md` 到项目根.\n\n### Step 4: 写入占位 CONTEXT.md 或 CONTEXT-MAP.md\n\n单语境占位 (H1 标题用 operator decide 的项目名, **不要事后通过 Edit 改 H1**, 那会被 pre-context-write-guard 拦截):\n\n```markdown\n# \u003C项目名> - 领域词汇表\n\n> 本文件是项目领域词汇的**单一事实源 (SSOT)**.\n> 仅 `domain-modeling` 技能可写; 其他技能按 `docs\u002Fagents\u002Fcontext-contract.md` 消费.\n\n---\n\n## Language\n\n\u003C!-- domain-modeling 会逐词添加 -->\n\n---\n\n## Flagged ambiguities\n\n\u003C!-- domain-modeling 会记录 -->\n```\n\n多语境:\n\n```markdown\n# CONTEXT Map\n\n| Context | Path                        | Owner   |\n| ------- | --------------------------- | ------- |\n| \u003Cctx-1> | src\u002F\u003Cctx-1>\u002Fdocs\u002FCONTEXT.md | @\u003Cteam> |\n```\n\n### Step 5: 注册物理护栏 (按需, 避免双重)\n\n**核心原则**: Claude Code 的 hook 是从用户级 + 项目级**叠加收集**而非 fallback, 同 matcher 重复注册会跑两次 (产生 systemMessage 重复 + state 文件读写竞态). 所以 hook 注册必须按环境分支.\n\n**Step 5a: 探测用户级是否已注册**\n\n读取 `~\u002F.claude\u002Fsettings.json` 的 `hooks.PreToolUse` + `PostToolUse` 列表, 看是否含同名 hook 文件名. 默认检测 6 个 hook (5 context-闭环 + pre-fs-guard):\n\n| Hook                           | 触发                                                     | 职责                                                                     |\n| ------------------------------ | -------------------------------------------------------- | ------------------------------------------------------------------------ |\n| `pre-context-write-guard.cjs`  | PreToolUse Write\u002FEdit\u002FMultiEdit\u002FBash                     | CONTEXT.md \u002F ADR 写入主权 + Bash 3-regex                                 |\n| `pre-stale-read.cjs`           | PreToolUse Write\u002FEdit\u002FMultiEdit\u002FBash (src\u002F)              | CONTEXT.md mtime 过期 -> advisory                                        |\n| `pre-read-contract.cjs`        | PreToolUse Write\u002FEdit\u002FMultiEdit\u002FNotebookEdit\u002FBash (src\u002F) | 写 src\u002F 前未读 CONTEXT.md -> advisory                                    |\n| `post-ssot-priority.cjs`       | PostToolUse Write\u002FEdit\u002FMultiEdit\u002FBash                    | team\u002Fproject\u002Fsub-context 术语冲突 -> stderr POST-FIX WARNING             |\n| `post-conflict-annotation.cjs` | PostToolUse Write\u002FEdit\u002FMultiEdit\u002FBash (tool_name 白名单) | skill 输出矛盾 ADR -> advisory                                           |\n| `pre-fs-guard.cjs`             | PreToolUse Bash                                          | 拦 `find \u002F` \u002F `grep -r \u002F` \u002F 尾随 `&` (2026-07 find.exe handle leak 防护) |\n\n**Step 5b: 三种决策**\n\n| 场景                    | 判定                            | 动作                                       |\n| ----------------------- | ------------------------------- | ------------------------------------------ |\n| 用户级**全无**同名 hook | 干净环境 (CI \u002F Docker \u002F 新机器) | 注册全部 6 hook 到 `.claude\u002Fsettings.json` |\n| 用户级**已有**部分同名  | 部分干净                        | 只注册用户级**没有**的 hook                |\n| 用户级**全有**同名 hook | 与现有用户级环境重叠            | 跳过项目级注册, 提示\"已由用户级提供\"       |\n\n**Step 5c: 项目级注册片段** (只在场景 1+2 才用)\n\n`.claude\u002Fsettings.json` `hooks` 追加:\n\n```json\n\"PreToolUse\": [\n  {\n    \"matcher\": \"Write|Edit|MultiEdit|Bash\",\n    \"hooks\": [\n      {\"type\": \"command\", \"command\": \"node .claude\u002Fhooks\u002Fpre-context-write-guard.cjs\", \"timeout\": 5},\n      {\"type\": \"command\", \"command\": \"node .claude\u002Fhooks\u002Fpre-stale-read.cjs\", \"timeout\": 5},\n      {\"type\": \"command\", \"command\": \"node .claude\u002Fhooks\u002Fpre-read-contract.cjs\", \"timeout\": 5}\n    ]\n  },\n  {\n    \"matcher\": \"Bash\",\n    \"hooks\": [\n      {\"type\": \"command\", \"command\": \"node .claude\u002Fhooks\u002Fpre-fs-guard.cjs\", \"timeout\": 5}\n    ]\n  }\n],\n\"PostToolUse\": [\n  {\n    \"matcher\": \"Write|Edit|MultiEdit|Bash\",\n    \"hooks\": [\n      {\"type\": \"command\", \"command\": \"node .claude\u002Fhooks\u002Fpost-ssot-priority.cjs\", \"timeout\": 5},\n      {\"type\": \"command\", \"command\": \"node .claude\u002Fhooks\u002Fpost-conflict-annotation.cjs\", \"timeout\": 5}\n    ]\n  }\n]\n```\n\n**Step 5d: 字节级操作纪律 (R5)**\n\nsettings.json 含 secret 字段时必须 byte-level (rb + regex + wb). 用 `Edit` 工具精准追加, 不 `Write` 整文件. 改后 `python3 -m json.tool` 校验 JSON 完整.\n\n**Step 5e: 验证**\n\n```bash\nbash .evals\u002Frun.sh --all   # 必须 10\u002F10 (hook 行为正确)\npython3 -c \"import json; print(json.load(open('.claude\u002Fsettings.json'))['hooks'])\"\n```\n\n### Step 6: GitHub Pull (模板规范演进同步)\n\n模板规范演进同步. 默认源 = `\u003Cowner>\u002F\u003Crepo>` GitHub 仓.\n\n```bash\n# 拉取最新模板规范到本项目 (增量, 不覆盖 PROTECTED)\nbash scripts\u002Fupdate.sh --from-git \u003Cowner>\u002F\u003Crepo>\n\n# 仅拉取指定文件 (gap-fill 模式)\nbash scripts\u002Fupdate.sh --from-git \u003Cowner>\u002F\u003Crepo> --only .claude\u002Frules\u002F scripts\u002F\n\n# 本地模板路径 (开发用)\nARTHUR_TEMPLATE=\u002Fpath\u002Fto\u002Flocal\u002Ftemplate bash scripts\u002Fupdate.sh\n\n# 强制覆盖 (会破坏 PROTECTED 之外的本地定制)\nbash scripts\u002Fupdate.sh --from-git \u003Cowner>\u002F\u003Crepo> --force\n```\n\n`update.sh` 自动:\n\n1. `git clone --depth=1 \u003Curl> .template-cache\u002F` (临时目录)\n2. sha256 比对每文件\n3. SAME -> skip \u002F DIFF -> skip (默认) 或 warn `--force` \u002F MISSING -> copy\n4. PROTECTED (`CLAUDE.md`, `CLAUDE.local.md`, `docs\u002FCONTEXT.md`, `.claude\u002Fsettings.json`, `.claude\u002Fsettings.local.json`, `docs\u002Fhandoff\u002F*`) 永不覆盖\n5. 清理临时 clone\n\n## Verification Checklist\n\n### Fresh \u002F Intermediate 模式必查\n\n- [ ] `docs\u002Fagents\u002Fcontext-contract.md` 存在\n- [ ] `docs\u002FCONTEXT.md` 或 `docs\u002FCONTEXT-MAP.md` 存在 (含 SSOT 头注释, H1 标题是正确项目名, **不在 setup 阶段 Edit H1**)\n- [ ] `docs\u002Fadr\u002F` 目录存在 (空目录也 OK)\n- [ ] 6 个 hook 文件存在于 `.claude\u002Fhooks\u002F` (pre-context-write-guard \u002F pre-stale-read \u002F pre-read-contract \u002F post-ssot-priority \u002F post-conflict-annotation \u002F pre-fs-guard)\n- [ ] **hook 注册按需** (Step 5b 三分支)\n- [ ] `domain-modeling` 在 `.claude\u002Fskills\u002F` (模板自带); `logicsync` + `self-evolving-rules` 由 plugin 全局供给 (fresh 模式不必复制到 `.claude\u002Fskills\u002F`, plugin 装上即有)\n- [ ] `docs\u002Frules\u002Fcontext-loop.md` 存在 (post reorg 2026-07-20)\n- [ ] Cross-file \u002F multi-hook changes that can drift **trigger** behavior run `boundary-testing`: **axis1 then axis2** (sequential; axis2 consumes axis1 evals). No standalone rule file; agents under plugin `agents\u002F`.\n- [ ] `arthurpower:self-evolving-rules` skill 可用 (user-invoked, 规则沉淀 6 步流程)\n- [ ] `scripts\u002Fbootstrap.sh` + `scripts\u002Fupdate.sh` 存在 + 可执行\n- [ ] `.evals\u002Frun.sh --all` 10\u002F10 PASS\n\n### Old-repo 模式必查 (增量接入, 不删旧)\n\n- [ ] Step 0 检测正确 (有 CLAUDE.md -> old-repo)\n- [ ] Step 0.5 gap-fill 列出 PULL_LIST, 调 update.sh\n- [ ] **现有 `CLAUDE.md` 未被修改** (sha256 before == sha256 after)\n- [ ] **现有 `docs\u002F` 全部文件未被修改** (除 `docs\u002FCONTEXT.md` 因 gap-fill 创建, `docs\u002Fagents\u002Fcontext-contract.md` 因 gap-fill 创建)\n- [ ] **现有任何文件未删除**\n- [ ] 新增的 hook \u002F rules \u002F skills 通过 update.sh 拉取, sha256 与模板一致\n- [ ] `.claude\u002Fsettings.json` 经 Step 5 dedup 决策后只追加必要的 hook\n- [ ] `.evals\u002Frun.sh --all` 在 old-repo 模式下应至少 5\u002F10 (因旧项目结构可能不符合全部 10 task 假设)\n\n### Setup 完成语义\n\nPASS = fresh 模式跑过 `.evals\u002Frun.sh --all` 10\u002F10 + 6 hook 全在; old-repo 模式现有文件零改动 + 缺的资产通过 update.sh 增量补齐 + dedup 决策正确执行.\n\n## References\n\n- 模板仓: https:\u002F\u002Fgithub.com\u002F\u003Cowner>\u002F\u003Crepo> (含 `scripts\u002Fbootstrap.sh` + `scripts\u002Fupdate.sh`)\n- 读侧契约: `docs\u002Fagents\u002Fcontext-contract.md`\n- 写侧主权: `.claude\u002Fskills\u002Fdomain-modeling\u002FSKILL.md`\n- 物理护栏: `.claude\u002Fhooks\u002Fpre-context-write-guard.cjs` (5 个 context-闭环 hook 的根)\n- 规则层 (always-on): `.claude\u002Frules\u002F{workflow,security-boundaries,git}.md`; 规则层 (on-demand): `docs\u002Frules\u002F{context-loop,task-templates,code-quality,memory}.md` — 见 `workflow.md` 当读\n- Boundary-testing SOP: `boundary-testing` skill — **axis1 then axis2** (sequential). Trigger-semantics only; public-entry input classes → `input-contract-tests`.\n- v3.0.0 changelog: 从 v2.0.0 升级, 新增 Step 0 mode detection + Step 0.5 gap-fill + Step 6 GitHub pull; 集成 pre-fs-guard (v2 漏) + post-ssot-priority \u002F post-conflict-annotation 修复版; Verification Checklist 拆 fresh \u002F old-repo 双分支\n- v3.0.0 -> user-invoked skill 形态: 从 slash command 改回 skill (`disable-model-invocation: true`), 与 plugin 其他 user-invoked skill (architecture-change-reviewer \u002F code-review) frontmatter 形态一致, 保持显式触发纪律\n",{"name":5,"tags":23,"author":33,"bucket":34,"version":35,"description":7,"related_skills":36,"disable-model-invocation":40},[24,25,26,27,28,29,30,31,32],"Setup","Bootstrap","ContextMap","Contract","OneShot","Hooks","Dedupe","Migration","GithubPull","Arthurpower","engineering","3.0.0",[37,38,39],"domain-modeling","logicsync","self-evolving-rules",true,"master","1a067ffc9024631d22ca8bf2b47ad81369f28056","arthurpower\u002Fskills\u002Fsetup-arthurpower",0,"https:\u002F\u002Fgithub.com\u002Fwinter6205\u002Farthurpower","https:\u002F\u002Fgithub.com\u002Fwinter6205","2026-10-28 23:46:38",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":40},[50,53,56],{"tool":51,"command":52},"npx","npx skills add winter6205\u002Farthurpower --skill setup-arthurpower",{"tool":54,"command":55},"bunx","bunx skills add winter6205\u002Farthurpower --skill setup-arthurpower",{"tool":57,"command":58},"pnpm","pnpm dlx skills add winter6205\u002Farthurpower --skill setup-arthurpower","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fwinter6205\u002Farthurpower\u002Fblob\u002Fmaster\u002Farthurpower\u002Fskills\u002Fsetup-arthurpower\u002FSKILL.md",[],[62,69,76,83,90,97],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":18},"01M7EFDX3VT33HSHDA17T9N9JJ","writing-plans","Use when turning a buildable spec into ordered tracer bullets after architecture-change-reviewer. Covers vertical slicing, dependency order, and headroom for the implementer. Triggers on 写计划, 拆任务, 任务分解, 制定方案, 跨文件改动, 计划.","https:\u002F\u002Fgithub.com\u002Fwinter6205\u002Farthurpower\u002Fblob\u002Fmaster\u002Farthurpower\u002Fskills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":18},"01M7EFDQV6SGJWDK634DWPFR35","wayfinder","Use when a chunk of work is more than one agent session can hold — plan it as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.","https:\u002F\u002Fgithub.com\u002Fwinter6205\u002Farthurpower\u002Fblob\u002Fmaster\u002Farthurpower\u002Fskills\u002Fwayfinder\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":18},"01M7EFDM9Y55GKYFGY96088BYB","verification-before-completion","This skill should be used when claiming \"完成\" \u002F \"done\" \u002F \"fixed\" \u002F \"passing\" \u002F \"ready to ship\", before trusting a subagent success report, or when checking \"对照计划\" \u002F \"对照 spec\" — whether this run's delivery matches its basis.","https:\u002F\u002Fgithub.com\u002Fwinter6205\u002Farthurpower\u002Fblob\u002Fmaster\u002Farthurpower\u002Fskills\u002Fverification-before-completion\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":18},"01M7EFDFCY4V0JMQHSEE34A2JS","using-agent-skills","Use when starting a new session, switching tasks, or unsure which arthurpower skill applies. Routes incoming work to the matching skill via flowchart before invoking. Activates on phrases like \"which skill should I use\", \"skill check\", \"pre-task skill check\", \"how to start\", \"router\", \"skill routing\", or when multiple competing skills could apply. Does not auto-invoke user-invoked authoring skills (skill-authoring, self-evolving-rules).","https:\u002F\u002Fgithub.com\u002Fwinter6205\u002Farthurpower\u002Fblob\u002Fmaster\u002Farthurpower\u002Fskills\u002Fusing-agent-skills\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":18},"01M7EFDB70ATNQASXP4BKDYGA6","test-driven-development","Use when implementing logic, fixing a bug, or changing behavior — write the failing test first (RED), then minimal code (GREEN), then refactor. Triggers on \"write the failing test first\", \"Prove-It\", or a bug that needs a reproduction test before the fix.","https:\u002F\u002Fgithub.com\u002Fwinter6205\u002Farthurpower\u002Fblob\u002Fmaster\u002Farthurpower\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":18},"01M7EFD6NPWFG5WSXT0DF07XH1","systematic-debugging","Use when debugging a test failure, build break, unexpected runtime error, flaky test, or hanging process. Triggers on phrases like \"fix this bug\", \"getting an error\", \"failing test\", \"flaky\", \"hanging\", \"halfway through debugging\", \"this used to work\", \"intermittent failure\", \"stack trace shows X\", or any case where behavior does not match expectations. Prevents shotgun debugging.","https:\u002F\u002Fgithub.com\u002Fwinter6205\u002Farthurpower\u002Fblob\u002Fmaster\u002Farthurpower\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]