# Team-Intelligence-Center

**Repository Path**: Zdevote/Team-Intelligence-Center

## Basic Information

- **Project Name**: Team-Intelligence-Center
- **Description**: Chinese-first, tool-neutral AI engineering workflow rules for Codex, Cursor, OpenSpec, and Superpowers teams.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-25
- **Last Updated**: 2026-09-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Team-Intelligence-Center

面向软件项目的轻量 AI 协作规则包：用 Workflow Core 约束动作边界，
用可独立选择的 Capability 承载调查、契约、验证、交接和项目记忆。

> Public preview：当前已发布版本为 `0.5.4`。

## 0.5.4 的主要修订

- 明确 PRD → SDD → TDD 的就绪条件，按可验收功能切片推进，复用已有基线和测试边界；
- 编码前核对项目地图、架构、复用与影响，维护需求、设计、任务、测试和证据的追溯；
- 明确按产品、变更、验证运行与发布版本落档，保留已有目录及唯一事实源；
- 提供可选 OpenSpec schema，执行前检查 proposal/specs/design/tasks，区分 CLI 状态与业务验收；
- 完善授权复用、长任务续接、功能分工、跨仓交接与记忆读写边界；
- 保留产品/UI 基线保护，清理旧 PRD 编辑器与工具指南中的重复流程；
- 增加真实 CLI/安装 fixture 和隔离 Agent 行为验证，交付以实际证据为准。

普通任务直接调查、修改和验证；规划、授权、验证、Review 和事实持久化分别判断。
Skills 按事实选择，工具可以替换，额外产物须有明确消费者。

规则与交付入口：

- [Workflow Core](Workflow/core.md)：执行条件与动作边界；
- [产物落档规则](Workflow/artifacts.md)：目录、归属、追溯和归档；
- [Capability Contract](Workflow/capability-schema.md)、[行为场景](Workflow/scenarios.json)；
- [Git 规则](Global-Rules/git-rules.md)；
- [0.5.4 版本记录](docs/releases/0.5.4/README.md)、[执行链路设计](docs/sdd/prd-sdd-tdd-delivery-chain/design.md)；
- [OpenSpec 接合指南](Design/development-paradigm-openspec-guide.md)。

## 五个独立维度

| 维度 | 可选策略 |
| --- | --- |
| 规划深度 | inline / brief / living |
| 执行授权 | autonomous / confirmation-required |
| 验证范围 | targeted / integration / e2e / operational |
| Review | self / independent / user-decision |
| 事实持久化 | task-context / OpenSpec / PRD / Runbook / Release / local candidate |

## Capability 模型

`Skills/` 下每个能力都使用 `tic_capability.v1` 声明：

- 何时使用、何时不使用；
- 是否产生外部副作用；
- 默认是否创建产物；
- 所需前置事实；
- 相关但不会自动调用的能力。

常用能力包括：

| 能力 | 用途 |
| --- | --- |
| `prd-author` | 新产品、重大旅程或显式 PRD 请求需要形成可确认产品基线时使用 |
| `prd-review-checklist` | 产品 owner 审查 PRD 是否足以支持正式实现时使用 |
| `code-investigator` | 用户要求追踪现有行为，或关键未知事实阻塞当前决策时调查 |
| `contract-handoff` | 共享契约跨实现边界且存在独立消费者时对齐语义 |
| `shared-domain-arbiter` | 并发 owner 在同一共享域发生真实冲突时裁决 ownership |
| `e2e-verification` | 局部检查不足以证明关键旅程时补充端到端证据 |
| `delivery-walkthrough` | 为明确的异步 review、QA 或使用者生成走查材料 |
| `post-dev-prd-sync` | 同步已批准且已交付行为；未批准的规格漂移只报告、不反写 PRD |
| `release-handoff` | 独立发布消费者需要部署、验证、监控或回滚信息时使用 |
| `collaboration-memory-maintainer` | 显式维护可确认、可过期、可审计的协作记忆 |

`tic-workflow-orchestrator` 仅保留为复杂规划和旧版迁移的兼容能力，不是普通
任务入口。

## 快速安装

先预览，再应用到业务项目：

```bash
bash /path/to/Team-Intelligence-Center/tools/install.sh \
  --preview \
  --rules-dir /path/to/Team-Intelligence-Center \
  /path/to/project

bash /path/to/Team-Intelligence-Center/tools/install.sh \
  --rules-dir /path/to/Team-Intelligence-Center \
  /path/to/project
```

安装器会生成轻量入口、工具规则、项目适配文件和 memory 骨架。普通刷新会
保留已有 `ai-harness/project-adapter.md`、共享 memory 和项目自定义内容。
只有显式传入 `--regenerate-adapter` 才会备份并重建 adapter。

可选安装 Codex 全局 Loader：

```bash
bash /path/to/Team-Intelligence-Center/tools/install-codex-global.sh \
  --dry-run \
  --rules-dir /path/to/Team-Intelligence-Center
```

Loader 只负责发现项目规则和提供 `tic-*` wrapper，不复制规则本体，也不
覆盖项目级决策。

完整安装、更新和目录说明见 [`USAGE.md`](USAGE.md) 与
[`docs/automation.md`](docs/automation.md)。

## 项目接入后的边界

- 项目 `AGENTS.md` 和 `ai-harness/project-adapter.md` 优先于通用模板。
- 普通任务不需要先调用 Orchestrator。
- 普通任务不默认创建 PRD；大型新产品或重大用户旅程缺少产品基线时先生成草稿。
- 不默认创建 SDD、Walkthrough、Release Handoff 或 session artifact。
- 按任务相关性在访问权限内只读查阅项目记忆；维护与写入需明确授权。
- 不默认执行 Git 分支、提交、push、merge、tag 或发布。
- Git 写操作获授权后使用统一类型分支、必填具体 scope 的中文 Conventional
  Commit，并在写入前通过分支名和提交信息校验器。
- 不默认安装 Git hooks、CodeGraph、浏览器 runner 或供应商工具。
- UI 和关键旅程只在结论需要时使用真实界面或 E2E 证据。

## Collaboration Memory

共享事实、决策、runbook 和团队约定位于 `ai-harness/memory/`；个人偏好和
待确认候选位于 gitignored 的 `.tic/local/`。它保存可复用结论，不保存原始
聊天、密钥、认证状态或未经确认的敏感推断。

读取与维护按 [`Workflow/core.md`](Workflow/core.md) §4.1 分别判断。相关项目
记忆可在访问权限内只读查阅；写入候选、修改、晋升和废弃核对明确授权。易变事实
重新核实，过期或冲突条目只作线索，Memory 不替代当前代码、规格和外部状态。

## 发布记录

`0.1.0`、`0.2.0`、`0.2.1` 的历史记录均保存在
[`docs/releases`](docs/releases)。

`0.2.2`、`0.3.0`、`0.5.0`、`0.5.1`、`0.5.2`、`0.5.3`、`0.5.4` 已归档，
当前已发布版本为 `0.5.4`。

0.4.0 从未作为公开版本发布；其开发中的 Collaboration Memory 工作已合并
到 0.5.0，不保留虚构的发布记录。

当前版本证据见
[`docs/releases/0.5.4`](docs/releases/0.5.4) 和
[研发链路验证](docs/test-evidence/prd-sdd-tdd-delivery-chain/README.md)。

## 验证

```bash
bash tools/validate-pack.sh
```

验证器覆盖版本一致性、Workflow 场景、Capability 契约、安装幂等、
Project Adapter 与共享 memory 保留、全局 wrapper、Git 建议只读边界及
分支名/提交信息校验器、Shell fixture。若本机存在 PowerShell，也会运行
等价 fixture。

## 开源与贡献

项目使用 Apache-2.0 License。贡献前请阅读
[`CONTRIBUTING.md`](CONTRIBUTING.md) 和 [`SECURITY.md`](SECURITY.md)。