c3-skill
为代码库构建可被AI安全导航与变更的架构模型
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：c3-skill。 它的用途是：为代码库构建可被AI安全导航与变更的架构模型 完整的 Skill 内容见：https://321skill.com/skills/c3-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用C3技能，帮我分析当前项目的服务层架构，并找出所有未被任何接口引用的孤立函数。” 它会先加载项目的C3架构模型，然后执行语义和图形查询，最终生成一份报告，列出可疑的孤立函数及其位置，并可以引导你创建一个“变更单元”来安全地移除或重构它们。
介绍
C3 解决的核心问题是：如何让大型语言模型（LLM）或AI智能体能够安全、准确地理解和修改你的代码架构，而不会引入破坏性变更。它通过创建一个被“冻结”的、机器可验证的架构模型（.c3/ 目录树）来实现，该模型是代码库的唯一真实来源，AI可以基于此进行查询、评估和变更。
使用C3时，你首先需要定义架构的“画布”（Canvas），即实体、属性和关系的词汇表，并录入初始事实。一旦事实被“冻结”，所有后续变更都必须通过“变更单元”（Change-unit）进行，这是一个包含决策记录和代码补丁的原子性操作包，确保架构图的完整性始终得到维护。
这个技能非常适合需要维护复杂代码库、并希望引入AI辅助进行架构分析、重构或大规模代码变更的开发者团队。它特别有助于在团队协作或AI自动化流程中，保持架构文档与代码实现的高度一致。
建议在项目早期或重构阶段引入C3。使用前需明确架构边界，并充分利用其“评估”（eval）功能来绑定模型与代码现实，避免模型与实际脱节。变更单元的设计应保持小而聚焦，以利于审查和冲突解决。
核心特点
与同类工具（如传统架构文档或代码生成工具）相比，C3的核心区别在于其“事实冻结”和“变更单元”机制，这从设计上保证了架构模型与代码的强一致性，并通过图约束（如防止孤立引用）和原子性变更，使AI驱动的修改具备可预测的安全性和完整性，而非仅提供静态的参考文档。
注意事项
不适合架构尚不清晰或频繁进行颠覆性重构的早期探索性项目。
常见问题
C3模型和代码不同步了怎么办？
使用 `c3x eval` 命令检查“漂移”（drift），并通过创建新的“变更单元”来对齐模型与代码。
C3能用于非代码项目吗？
目前主要设计用于软件代码库，其评估（eval）功能深度绑定代码结构和文件。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/c3-skill/raw/index.md 读取 c3-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/c3-skill/raw/index.md（查看排版版本）