WoJiSama/skill-based-architecture

#!/usr/bin/env bash

<p align="center">   <a href="https://github.com/WoJiSama/skill-based-architecture/stargazers">

<a href="https://github.com/WoJiSama/skill-based-architecture/stargazers">

<img alt="GitHub stars" src="https://img.shields.io/github/stars/WoJiSama/skill-based-architecture?style=flat&logo=github">

</a>   <a href="https://github.com/WoJiSama/skill-based-architecture/forks">     <img alt="GitHub forks" src="https://img.shields.io/github/forks/WoJiSama/skill-based-architecture?style=flat&logo=github">

<a href="https://github.com/WoJiSama/skill-based-architecture/forks">

<img alt="GitHub forks" src="https://img.shields.io/github/forks/WoJiSama/skill-based-architecture?style=flat&logo=github">

</a>   <a href="LICENSE">     <img alt="License" src="https://img.shields.io/github/license/WoJiSama/skill-based-architecture?style=flat">

<a href="LICENSE">     <img alt="License" src="https://img.shields.io/github/license/WoJiSama/skill-based-architecture?style=flat">   </a>

<img alt="License" src="https://img.shields.io/github/license/WoJiSama/skill-based-architecture?style=flat">

git clone https://github.com/WoJiSama/skill-based-architecture.git \

- Use [`examples/simple-repo/`](examples/simple-repo/) as a tiny local fixture with deliberately duplicated instructions. - Use [`COPY-PASTE-INPUT.md`](examples/simple-repo/COPY-PASTE-INPUT.md) when a hosted environment accepts pasted files

- [Run SBA in Telegram or WhatsApp through ClawMama](https://app.clawmama.run/skills/i78bb1/hermes?utm_source=github&utm_medium=issue&utm_campaign=skill_outreach_wojisama_skill_based_architecture) for a lightweight external preview. Do not 

License: [LICENSE](LICENSE). Community discussion: [LinuxDO](https://linux.do/).

<a href="https://www.star-history.com/?repos=WoJiSama%2Fskill-based-architecture&type=date&legend=top-left">

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

<p align="center">   <a href="https://github.com/WoJiSama/skill-based-architecture/stargazers">

<a href="https://github.com/WoJiSama/skill-based-architecture/stargazers">

<img alt="GitHub stars" src="https://img.shields.io/github/stars/WoJiSama/skill-based-architecture?style=flat&logo=github">

</a>   <a href="https://github.com/WoJiSama/skill-based-architecture/forks">     <img alt="GitHub forks" src="https://img.shields.io/github/forks/WoJiSama/skill-based-architecture?style=flat&logo=github">

<a href="https://github.com/WoJiSama/skill-based-architecture/forks">

<img alt="GitHub forks" src="https://img.shields.io/github/forks/WoJiSama/skill-based-architecture?style=flat&logo=github">

</a>   <a href="LICENSE">     <img alt="License" src="https://img.shields.io/github/license/WoJiSama/skill-based-architecture?style=flat">

<a href="LICENSE">     <img alt="License" src="https://img.shields.io/github/license/WoJiSama/skill-based-architecture?style=flat">   </a>

<img alt="License" src="https://img.shields.io/github/license/WoJiSama/skill-based-architecture?style=flat">

git clone https://github.com/WoJiSama/skill-based-architecture.git \

- 把 [`examples/simple-repo/`](examples/simple-repo/) 当作本地最小 fixture；其中故意放了互相重复的指令。 - Hosted 环境支持粘贴文件时，使用 [`COPY-PASTE-INPUT.md`](examples/simple-repo/COPY-PASTE-INPUT.md)。 - 通过 ClawMama [在 Telegram 或 WhatsApp 中运行 SBA](https://app.clawmama.r

- 通过 ClawMama [在 Telegram 或 WhatsApp 中运行 SBA](https://app.clawmama.run/skills/i78bb1/hermes?utm_source=github&utm_medium=issue&utm_campaign=skill_outreach_wojisama_skill_based_architecture)，进行轻量外部体验。不要上传敏感项目规则。

许可证：[LICENSE](LICENSE)。社区讨论：[LinuxDO](https://linux.do/)。

<a href="https://www.star-history.com/?repos=WoJiSama%2Fskill-based-architecture&type=date&legend=top-left">

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

trap 'rm -f "$MIGRATION_EVIDENCE_JSON"' EXIT

<svg xmlns="http://www.w3.org/2000/svg" width="680" height="620" viewBox="0 0 680 620" role="img">

<svg xmlns="http://www.w3.org/2000/svg" width="680" height="330" viewBox="0 0 680 330" role="img">

<svg xmlns="http://www.w3.org/2000/svg" width="680" height="540" viewBox="0 0 680 540" role="img">

<svg xmlns="http://www.w3.org/2000/svg" width="680" height="800" viewBox="0 0 680 800" role="img">

<svg xmlns="http://www.w3.org/2000/svg" width="680" height="1420" viewBox="0 0 680 1420" role="img">

<svg xmlns="http://www.w3.org/2000/svg" width="680" height="906" viewBox="0 0 680 906" role="img">

<svg xmlns="http://www.w3.org/2000/svg" width="680" height="502" viewBox="0 0 680 502" role="img">

项目地址：[WoJiSama/skill-based-architecture](https://github.com/WoJiSama/skill-based-architecture)

如果一个 skill 只有几条稳定原则，单个 `SKILL.md` 就够了。参考 [forrestchang/andrej-karpathy-skills](https://github.com/forrestchang/andrej-karpathy-skills) 这类项目，核心价值不是目录复杂，而是规则写得克制、具体、可检查。

# Cursor 用户级 skill git clone https://github.com/WoJiSama/skill-based-architecture.git \

git clone https://github.com/WoJiSama/skill-based-architecture.git \

# Cursor 项目级 skill git clone https://github.com/WoJiSama/skill-based-architecture.git \

git clone https://github.com/WoJiSama/skill-based-architecture.git \

# 通用项目内安装 git clone https://github.com/WoJiSama/skill-based-architecture.git \

git clone https://github.com/WoJiSama/skill-based-architecture.git \

[https://github.com/WoJiSama/skill-based-architecture](https://github.com/WoJiSama/skill-based-architecture)

<a href="https://www.star-history.com/?repos=WoJiSama%2Fskill-based-architecture&type=date&legend=top-left">

<picture>    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=WoJiSama/skill-based-architecture&type=date&theme=dark&legend=top-left" />    <source media="(prefers-color-scheme: light)" srcset="h

<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=WoJiSama/skill-based-architecture&type=date&theme=dark&legend=top-left" />

<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=WoJiSama/skill-based-architecture&type=date&legend=top-left" />

<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=WoJiSama/skill-based-architecture&type=date&legend=top-left" />

- Upstream ownership convergence landed in commit `5a9785d`. The complete Drift Gate is owned by `task-execution.md`; Plan, information-model, distillation, documentation-maintenance, and Closure responsibilities remain with their own route

- Upstream closure passed `scripts/check-all.sh`, including both temporary downstream journeys, self-hosting scenarios, template/self-hosting conformance, shell/path integrity, and orphan/reachability checks. The D7 simulation found one com

- Chaos adaptation landed in exact meta commit `5bad9fd` and was pushed on `codex/rule-ownership-local-action-20260727`. Codeup MR [#17](https://codeup.aliyun.com/60dd34bf4690c27532d3d021/aiinfra/chaos/change/17) is open and pending from th

- **0.77 assembly:** `aii update release-0.77_shiqi --no-pull --no-self-upgrade` assembled the canonical commit. Backend and frontend canonical, `.codex`, and `.claude` trees are recursively identical, while both business repositories retai

- **Database-change dossier:** the 0.77 iteration-testing-mode `prd.md` now has a separate schema-impact checkpoint and its sibling `schema.sql` contains the live MySQL 8.0.27 baseline, complete target DDL, forward schema/data update, read-

- **Canonical MR:** Codeup MR `#22` is `https://codeup.aliyun.com/60dd34bf4690c27532d3d021/aiinfra/chaos/change/22`, source `codex/plan-composition-db-artifacts-20260803`, target `master`, state `待合并`, one commit, eight files, and `无代码冲突`. 

- Consumes: T1-T3 final wording. - Produces: owner/hook assertions and transcript-shaped failure-learning scenarios. - Acceptance: checks fail if Rule Update loses complete ownership, consumers copy its procedure, first failures create a le

- Acceptance: checks fail if Rule Update loses complete ownership, consumers copy its procedure, first failures create a ledger, retries count as recurrence, activation repair is skipped, or shared gates bypass approval.

Use the files under: https://github.com/WoJiSama/skill-based-architecture/tree/main/examples/simple-repo/repo

https://github.com/WoJiSama/skill-based-architecture/tree/main/examples/simple-repo/repo

Executable file

Executable file

Anthropic's public [`skills` repository](https://github.com/anthropics/skills) defines the **minimal** skill shape: a folder with a `SKILL.md`, plus frontmatter where `name` identifies the skill and `description` explains what it does and w

<!-- external-fact: verified=2026-04-28 source=https://code.claude.com/docs/en/skills -->

<!-- external-fact: verified=2026-04-28 source=https://docs.cursor.com/en/context -->

<!-- external-fact: verified=2026-04-28 source=https://code.claude.com/docs/en/skills -->

<!-- external-fact: verified=2026-04-28 source=https://developers.openai.com/codex/guides/agents-md -->

<!-- external-fact: verified=2026-04-28 source=https://docs.windsurf.com/windsurf/cascade/memories -->

<!-- external-fact: verified=2026-04-28 source=https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/gemini-md.md -->

<!-- external-fact: verified=2026-04-28 source=https://opencode.ai/docs/rules/ -->

A project skill captures *this project's* rules and routing. General-purpose capabilities — planning, security review, writing tests, research — are better built once in a reusable skill (e.g. [`obra/superpowers`](https://github.com/obra/su

The pattern is adopted from [OpenSpec](https://github.com/Fission-AI/OpenSpec)'s `<context>` / `<rules>` injection approach, adapted to our routing-table model.

#!/usr/bin/env bash

find . -name '*.bak' -type f -delete

trap 'rm -rf "$tmp" "$before"' EXIT

trap 'rm -rf "$tmp" "$before"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp" "$before" "$after_apply"' EXIT

rm -rf "$tmp"

rm -rf "$tmp"

rm "$skill_root/gotchas/shared.md"

rm -rf "$tmp"

rm -rf "$tmp"

rm -rf "$tmp"

trap 'rm -rf "$tmp"' EXIT

rm -rf "$skill/scripts"

trap 'rm -rf "$tmp"' EXIT

rm "$skill/references/business/unregistered.md"

rm "$skill/references/navigation.md"

rm "$root/services/billing/skills/billing/references/business/billing.md"

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

#!/usr/bin/env bash

trap 'rm -rf "$tmp"' EXIT

#!/usr/bin/env bash

#!/usr/bin/env bash

#!/usr/bin/env bash

#!/usr/bin/env bash

[Credential-related source omitted]

trap 'rm -rf "$TMP"' EXIT

#!/usr/bin/env bash

#!/usr/bin/env bash

#!/usr/bin/env bash

find "$target/skills/$name" -maxdepth 1 -type f      -name 'SKILL.*.md.template' ! -name 'SKILL.md.template' -delete

find "$target/skills/$name" -type f \( -name '*.md.template' -o -name '*.yaml.template' \) -delete

find . -name '*.bak' -type f -delete

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

find . -name '*.bak' -type f -delete

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

rm -f "$owner.bak"

trap 'rm -rf "$tmp"' EXIT

rm -f "$owner.bak"

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

trap 'rm -rf "$tmp"' EXIT

#!/usr/bin/env bash

find "$stage" -name '*.bak' -type f -delete

cleanup() { rm -rf "$stage"; }

for path in "${created_paths[@]}"; do rm -rf "$TARGET/$path"; done

#!/usr/bin/env node

#!/usr/bin/env bash

#!/usr/bin/env node

fs.writeFileSync(path.join(rulesDir, 'bom.md'), '<U+FEFF>## BomHeadingZzz\n\nContent about BomKeyword99.\n');

Schema check: Claude Code CLI v2.1+ uses the nested hook format (`matcher` -> `hooks[]` -> `{type,command}`). If a hook appears configured but does not fire, inspect hook events with the CLI's verbose hook output. <!-- external-fact: verifi

<!-- external-fact: verified=2026-05-06 source=https://code.claude.com/docs/en/hooks -->

Origin: trust-boundary principle condensed from [OthmanAdi/planning-with-files](https://github.com/OthmanAdi/planning-with-files).

#!/usr/bin/env bash

#!/usr/bin/env bash

<!-- external-fact: verified=2026-04-28 source=https://code.claude.com/docs/en/skills -->

# - workflows/update-upstream.md sets synced_sha (final step) after each refresh. # - scripts/upstream-status.sh reads it to report what's new upstream since then. upstream: https://github.com/WoJiSama/skill-based-architecture

# - scripts/upstream-status.sh reads it to report what's new upstream since then. upstream: https://github.com/WoJiSama/skill-based-architecture synced_sha: <set by update-upstream.md on first refresh>

upstream: https://github.com/WoJiSama/skill-based-architecture

Origin: condensed from [OthmanAdi/planning-with-files](https://github.com/OthmanAdi/planning-with-files) 5-Question Reboot Test.

#!/usr/bin/env bash

#!/usr/bin/env bash

trap 'rm -f "$PARSED_FILE"' EXIT

#!/usr/bin/env bash

#!/usr/bin/env bash

#!/usr/bin/env bash

rm -f "$REFERENCE_REPORT" "$REFERENCE_INPUT"

#!/usr/bin/env bash

#!/usr/bin/env bash

TMP_DIR="$(mktemp -d)"; trap 'rm -rf "$TMP_DIR"' EXIT

#!/usr/bin/env bash

CLEAN=""; trap '[[ -n "$CLEAN" ]] && rm -rf "$CLEAN"' EXIT

3. `rules/change-discipline.md` immediately before the first mutation 4. **Verify the invoked skill is present** — `ls skills/superpowers/SKILL.md` must exist. If not:    - Stop and report: "This workflow depends on skills/superpowers/. Ins

4. **Verify the invoked skill is present** — `ls skills/superpowers/SKILL.md` must exist. If not:    - Stop and report: "This workflow depends on skills/superpowers/. Install it first: `git clone https://github.com/obra/superpowers skills/s

- Stop and report: "This workflow depends on skills/superpowers/. Install it first: `git clone https://github.com/obra/superpowers skills/superpowers`."

<!-- upstream-source: repo=https://github.com/WoJiSama/skill-based-architecture.git -->

tmp="$(mktemp -d)"    git clone https://github.com/WoJiSama/skill-based-architecture.git "$tmp/upstream"

git clone https://github.com/WoJiSama/skill-based-architecture.git "$tmp/upstream"

```bash     printf 'upstream: %s\nsynced_sha: %s\nsynced_date: %s\n' \       "https://github.com/WoJiSama/skill-based-architecture" \

printf 'upstream: %s\nsynced_sha: %s\nsynced_date: %s\n' \       "https://github.com/WoJiSama/skill-based-architecture" \       "$(git -C "$tmp/upstream" rev-parse HEAD)" "$(date +%F)" > "skills/$NAME/.upstream-sync"

"https://github.com/WoJiSama/skill-based-architecture" \

<!-- external-fact: verified=2026-04-28 source=https://code.claude.com/docs/en/skills -->

https://github.com/WoJiSama/skill-based-architecture.git