#C3 CLI: `bash <技能目录>/bin/c3x.sh <命令> [参数]` 命令|目的 ---|--- `初始化` |脚手架`.c3/` `列表` |拓扑（`--json`、`--flat`、`--compact`） `检查` |结构验证（`--json`） `添加 <类型> ` |创建实体（`--container`、`--feature`） `代码图` |支架“.c3/code-map.yaml”，带有所有组件的存根+引用 `查找 <文件或全局>` |文件或 glob → 组件 + 引用 (`--json`) `覆盖范围` |代码映射覆盖率统计信息（JSON 默认） `add` 的类型：`container`、`component`、`ref`、`adr`、`recipe` ** ** ## 意图分类关键词|欧普|参考 ---|---|--- 采用、init、脚手架、引导程序、onboard、“创建 .c3”、“设置架构”| **船上** | `参考文献/onboard.md` 哪里、解释、如何、图表、跟踪、“告诉我”、“是什么”、“列出组件”| **查询** | `参考文献/query.md` 审核、验证、“检查文档”、漂移、“文档是最新的”、“验证文档”| **审计** | `参考文献/audit.md` 添加、更改、修复、实施、重构、删除、迁移、提供、设计 | **改变** | `参考文献/change.md` 模式、约定、“创建引用”、“更新引用”、“列出引用”、标准化 | **参考** | `参考文献/ref.md` 影响、“破坏了什么”、评估、扫除、“这安全吗”| **扫一扫** | `参考文献/sweep.md` 菜谱、“端到端跟踪”、“横切流程”、“X 如何流动”| **查询**（读取）/ **更改**（创建）| `references/query.md` / `references/change.md` ** ** ## 调度 1. 对 op 进行分类（不明确 → `AskUserQuestion` 有 6 个选项） 2. 加载 `references/.md` 3.执行（使用Task工具进行并行） ** ** ## 前提条件除船上外的每次操作之前： bash /bin/c3x.sh list --json 失败/空→路线到**船上** ** ** ## 假设_模式会话的第一个“AskUserQuestion”拒绝→“ASSUMPTION_MODE = true”。 * 永远不要再调用 `AskUserQuestion` * 高影响力：状态假设，标记“[ASSUMED]” * 低影响：自动继续 ** ** ## 共享规则 **经常运行`c3x check`** - 在创建/编辑任何“.c3/”文档之后。它捕获损坏的 YAML frontmatter、缺少必需的部分、错误的实体引用和代码映射问题。将错误 (`✗`) 视为阻碍因素。 **如果出现以下情况，请立即停止：** * 不使用 ADR 编辑代码 → 首先创建 ADR * 猜测意图 → `AskUserQuestion` （如果 ASSUMPTION_MODE 则跳过） * 跳转到组件→开始Context down * 无需代码检查即可更新文档 **文件上下文 — 在读取或更改任何文件之前必须提供：** bash <技能目录>/bin/c3x.sh 查找 <文件路径> bash /bin/c3x.sh Lookup 'src/auth/**' # 目录级上下文的 glob 返回的 refs = 硬约束，每一项都必须得到尊重。当任何文件路径出现时运行。跨目录工作时使用 glob。没有匹配=未知，谨慎行事。 **层导航：**上下文→容器→组件 **文件结构：** .c3/ ├── README.md # 上下文 (c3-0) ├── adr/adr-YYYYMMDD-slug.md ├── refs/ref-slug.md ├── 食谱/recipe-slug.md └── c3-N-名称/ ├── README.md # 容器 └── c3-NNN-component.md ** ** ## 操作 ### 船上没有“.c3/”或重新加载。 `c3x init` → 发现 → 注入 CLAUDE.md → 显示功能。详细信息：`references/onboard.md` ###查询 `c3x list` → 匹配实体 → 阅读文档 → 探索代码。详细信息：`references/query.md` ###审核 `c3x check` → `c3x list --json` → 语义阶段。输出：通过/警告/失败表。详细信息：`references/audit.md` ###改变 `c3x list --json` → `c3x Lookup` 每个文件 → 影响 → ADR → 批准 → `c3x Lookup` 每个文件编辑前 → 执行 → `c3x check`。配置门：立即实施或“状态：已配置”。详细信息：`references/change.md` ### 参考模式：添加/更新/列表/使用。详细信息：`references/ref.md` ###扫一扫 `c3x list --json` → 受影响的实体 → 并行评估 → 综合。仅供参考。详细信息：`references/sweep.md` ** ** ## CLAUDE.md 注入（板载） # 架构该项目使用“.c3/”中的 C3 文档。对于架构问题、更改、审核、文件上下文 -> `/c3`。操作：查询、审核、更改、引用、清除。文件查找：`c3x Lookup ` 将文件/目录映射到组件+引用。 ## 能力展示（船上） ## 您的 C3 工具包已准备就绪 |命令|它有什么作用 | |---------|-------------| | `/c3` 查询 |询问建筑 | | `/c3` 审计 |验证文档 | | `/c3` 更改 |修改架构 | | `/c3` 参考 |管理模式 | | `/c3` 扫描 |影响评估| | `/c3` 食谱 |端到端追踪横切关注点 | | `c3x 查找 <文件或 glob>` |文件或目录→组件+管理参考| | `c3x 覆盖范围` |查看已映射、已排除、未映射的内容 | 只需说出“/c3”+您想要的内容即可。

c3

包含技能