> For the complete documentation index, see [llms.txt](https://zhouhao4221.gitbook.io/haiqing-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zhouhao4221.gitbook.io/haiqing-docs/claude.md).

# CLAUDE.md

本文件为 Claude Code 在此仓库中工作时提供指导。

## 项目性质

这是一个原理解释与方法论仓库，不是软件应用。没有构建系统、测试运行器或部署流程。所有内容均为 Markdown 文件。

**主要目的有三：**

* **解释原理**：说清楚为什么这样做，背后的逻辑是什么
* **输出教程**：给出可操作的步骤，读者能照着做
* **沉淀方法**：将实践提炼为可复用的框架和流程

写作时优先考虑"读者能从中学到什么、能做到什么"，而非"记录我们内部怎么做的"。

## 仓库结构

```
00-principles/   所有其他决策追溯的核心原则
01-thinking/     AI 驱动工程的思维模型
02-design/       架构和系统设计实践
03-build/        AI 辅助开发实践与交付标准
04-prompt/       版本化提示资产（code/、design/、review/、workflow/、templates/）
05-workflow/     标准化工程流程
06-team/         角色、职责、协作模式
07-tooling/      AI 工具栈文档与采用流程
08-metrics/      指标定义与测量方法
09-vision/       长期方向与演进阶段
```

每个目录都有一个 README.md，说明其目的和涵盖的主题。

## 工作规则

* 直接提交并推送到 main，不创建 PR 或功能分支
* 提示文件修改时，提交信息必须说明修改原因
* commit 格式：`<type>: <中文描述>`，type 使用 docs / refactor / feat / fix
* 执行任何编辑前先明确结构化输入；模糊的需求产生无用的输出

## 内容写作标准

* **原理类**：先说问题，再说原因，最后给判断标准。不写"应该这样做"，写"为什么这样做"
* **教程类**：分步骤，每步有明确的输入和输出，读者能照着执行
* **方法类**：给出框架结构，说明适用场景和不适用场景，避免放之四海皆准的空话

## 跨章节处理

* 概念属于某一章节时，其他章节用链接引用，不复制内容
* 新增顶级目录前需明确说明用途，不随意扩展结构

## AI 上下文管理

所有 AI 相关信息（提示、规则、上下文）保存在本仓库内，不依赖外部提示管理系统。跨仓库共享的内容通过文件包或文件镜像处理，详见 README。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://zhouhao4221.gitbook.io/haiqing-docs/claude.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.