context

Context - 项目上下文管理

管理 .context/ 目录结构，为 LLM 工具提供决策审计链。

使用方法

/context <subcommand> [options]

子命令

子命令	说明
init	初始化 .context/ 目录结构
log <message>	（可选）手动追加备注到 session.log，commit 时会合并
show	查看当前分支的 session.log
compress	压缩 session.log → uncommit.md（手动预览用）
history	查看 history/commits.md
squash <ids...>	合并多条 history 记录（配合 git squash）

核心用法：init 一次，之后只管开发。/ccg:commit 提交时自动从 git diff 分析决策并归档到 history/。log 仅在你想手动补充备注时使用。

---

执行工作流

子命令：init

[模式：初始化]

在当前项目根目录创建 .context/ 结构：

1. 检测项目根目录（查找 .git/）
2. 若 .context/ 已存在，跳过已有文件，仅补全缺失
3. 创建以下结构：

.context/
├── .gitignore
├── .gitattributes
├── prefs/
│   ├── coding-style.md
│   └── workflow.md
├── current/
│   └── branches/
│       └── .gitkeep
└── history/
    ├── commits.jsonl
    ├── commits.md
    └── archives/
        └── .gitkeep

1. 创建 .context/.gitignore：

# Ephemeral workspace — never commit
current/

# Raw interaction logs — always local only
**/session.log
**/session.raw.log
**/*.session.log
**/*.raw.log

# Editor / temp
**/*.tmp
**/*.bak
**/*.swp

1. 创建 .context/.gitattributes：

# JSONL append-only: 'union' merge reduces conflicts
history/commits.jsonl merge=union
history/archives/*.jsonl merge=union

1. 创建 .context/prefs/coding-style.md（团队编码规范模板）：

# Coding Style Guide

> 此文件定义团队编码规范，所有 LLM 工具在修改代码时必须遵守。
> 提交到 Git，团队共享。

## General
- Prefer small, reviewable changes; avoid unrelated refactors.
- Keep functions short (<50 lines); avoid deep nesting (≤3 levels).
- Name things explicitly; no single-letter variables except loop counters.
- Handle errors explicitly; never swallow errors silently.

## Language-Specific
<!-- 根据项目语言补充，例如：-->
<!-- ### TypeScript -->
<!-- - Use strict mode; prefer `interface` over `type` for object shapes. -->

## Git Commits
- Conventional Commits, imperative mood.
- Atomic commits: one logical change per commit.

## Testing
- Every feat/fix MUST include corresponding tests.
- Coverage must not decrease.
- Fix flow: write failing test FIRST, then fix code.

## Security
- Never log secrets (tokens/keys/cookies/JWT).
- Validate inputs at trust boundaries.