name	theking
description	theking：项目知识库 + spec-driven 长程任务工作流。初始化后生成项目级 skill（workflow-governance、knowledge-base），日常开发由项目级 skill 接管。触发词包括 spec-driven、sprint、task、review loop、长程任务、任务拆解、TDD workflow、agent collaboration、SDD、评审闭环、持续 review、项目知识库、知识沉淀、分析文档。

theking

theking 是安装器：首次使用时初始化项目的 .theking/ 知识库和治理体系。初始化完成后，日常开发由两个项目级 skill 接管：

workflow-governance — 开发工作流治理（状态机、硬规则、分流决策、review loop、agent 触发）
knowledge-base — 项目知识沉淀（写入位置、生命周期、PLACEHOLDER 检测与自动填充）

Bootstrap（唯一职责）

先安装 workflowctl。推荐使用独立工具环境，不要依赖系统自带的旧版 pip：

pipx install /path/to/theking
# 或
uv tool install /path/to/theking

必须先运行以下命令确保项目已初始化。此命令幂等，重复运行不会覆盖已有文件：

workflowctl ensure --project-dir . --project-slug <PROJECT_SLUG>

其中：

workflowctl 是已安装到 PATH 的 theking CLI 命令
--project-dir . 表示你在项目根目录执行命令
<PROJECT_SLUG> 是项目名的 kebab-case 形式

兼容性说明：推荐长期只记住“在项目根目录运行时传 --project-dir .”。--project-dir 要求项目目录名和 --project-slug 精确一致；如果你的目录名和 slug 不一致，继续使用 --root <项目父目录> --project-slug <slug>。如果你手上只有 .theking 路径，传 --project-dir .theking 即可。

例如，对于 /home/user/code/my-app 项目：

cd /home/user/code/my-app
workflowctl ensure --project-dir . --project-slug my-app

此命令会：

创建 .theking/ 目录结构（context、memory、agents、commands、skills、hooks、prompts、verification、workflows）
在 .theking/agents|commands|skills|hooks|prompts 下生成共享 authored 资产
生成 .claude/agents|commands|skills/ 与 .codebuddy/agents|commands|skills/ 暴露层（优先软链到 .theking/ 下对应目录，失败回退为复制）
生成 .github/skills/ 和 .github/prompts/ 导出层
生成 .claude/settings.json 和 .codebuddy/settings.json（包含 PreToolUse/PostToolUse hooks）
生成 CLAUDE.md / CODEBUDDY.md / AGENTS.md 入口文件
生成 .kimi/agent.yaml + .kimi/agents/*.yaml（Kimi Code CLI 原生 YAML agent + 10 份 subagents），并 symlink .kimi/skills/、.kimi/AGENTS.md
生成 project.md（如果不存在）

Bootstrap 后的工作流底线

初始化完成后，日常开发由项目内的 workflow-governance skill 接管。第一步不是宣告“轻量流程”，而是完成最小上下文初勘：先看相关代码、测试、文档、报错，再决定走完整流程还是轻量流程。

轻量流程只减少 planner 拆解开销，不减少交付要求：完整 spec、TDD、build/lint/type/unit、执行画像验证、code review、check/sprint-check 仍然是底线。

显式反例：

👑 [decree] 此旨意走轻量流程。
理由：看起来只是个小 bug。

正确做法：

👑 [decree] 上下文初勘：
- 已查看：<代码/测试/文档/报错>
- 影响面：<模块/接口/用户流程>
- 风险标签：<无 / auth / input / api / web.browser / ...>
- 未决问题：<无 / 列表>

👑 [decree] 此旨意走<完整|轻量>流程。
理由：<基于已查看证据的判断>

compact 或切到另一个 AI 工具后，不要重新猜这道旨意做到哪一步。先运行：

workflowctl status --project-dir . --project-slug <PROJECT_SLUG>

如果已经完成分流，但还没真正进入 task，把下一步动作落到 decree checkpoint：

workflowctl checkpoint --project-dir . --project-slug <PROJECT_SLUG> --phase phase-2-triage --flow <full|lightweight> --summary "<一行摘要>" --next-step "<下一步动作>"

Post-Bootstrap

初始化完成后，检查 .theking/context/ 下的文件是否包含  标记。如果有，按 knowledge-base skill 的分析流程主动填充。

之后的所有开发工作流和知识沉淀操作，由项目级 skill 接管，不再需要本 skill。

初始化产物

<project>/
├── .theking/
│   ├── README.md
│   ├── bootstrap.md          ← 多工具共享入口
│   ├── context/              ← 稳定项目知识
│   ├── memory/               ← 临时补充记忆
│   ├── agents/               ← 10 个 agent 定义（canonical authored source）
│   ├── commands/             ← 共享命令定义
│   ├── skills/               ← 项目级 skill（canonical authored source）
│   │   ├── workflow-governance/SKILL.md
│   │   └── knowledge-base/SKILL.md
│   ├── hooks/                ← hook 脚本 authored source
│   ├── prompts/              ← GitHub Copilot prompt authored source
│   ├── verification/         ← 验证画像
│   ├── runs/                 ← 临时运行产物
│   └── workflows/<slug>/    ← project / sprint / task 工件
├── CLAUDE.md                 ← Claude Code 入口 → .theking/bootstrap.md
├── CODEBUDDY.md              ← CodeBuddy 入口 → .theking/bootstrap.md
├── AGENTS.md                 ← 通用 agent 入口 → .theking/bootstrap.md（Kimi 也读）
├── .claude/
│   ├── agents/               ← runtime 暴露层（优先软链）
│   ├── commands/             ← runtime 暴露层（优先软链）
│   ├── skills/               ← runtime 暴露层（优先软链）
│   └── settings.json
├── .github/
│   ├── prompts/              ← GitHub Copilot 导出层
│   └── skills/               ← GitHub Copilot 导出层
├── .codebuddy/
│   ├── agents/               ← runtime 暴露层（物化，CodeBuddy 方言 frontmatter）
│   ├── commands/             ← runtime 暴露层（优先软链）
│   ├── skills/               ← runtime 暴露层（优先软链）
│   └── settings.json
└── .kimi/
    ├── agent.yaml            ← Kimi 主 agent（extend: default，声明 10 个 subagents）
    ├── agents/               ← 10 份 subagent YAML，system_prompt_path → .theking/agents/*.md
    ├── AGENTS.md             ← 软链到根 AGENTS.md
    └── skills/               ← 软链到 .theking/skills/

name	theking
description	theking：项目知识库 + spec-driven 长程任务工作流。初始化后生成项目级 skill（workflow-governance、knowledge-base），日常开发由项目级 skill 接管。触发词包括 spec-driven、sprint、task、review loop、长程任务、任务拆解、TDD workflow、agent collaboration、SDD、评审闭环、持续 review、项目知识库、知识沉淀、分析文档。