AiCoding

AiCoding 是本地 AI coding 工作流的平台集成、安装、治理和 CodingKit 资产仓库。它负责 kit 注册表、hook、验证入口、发布治理和 Go CLI 控制面，不拥有嵌入式 skill 源码。

中文 | English

项目边界

• 平台仓库：集成 CodingKit 资产、kit registry、本地 hook、Taskfile 路由、发布治理和 Go CLI 门禁。
• 源码边界：权威 skill/plugin 源码位于 CodingKit/agents/skills 子模块和对应生成资产。
• 运行边界：插件 runtime 状态通过安装、更新和验证流程管理，不直接改 Codex cache。
• 发布边界：平台版本、kit/component 版本和 milestone tag 使用独立命名空间。

当前架构

Go CLI 是默认控制面，负责 bootstrap、Smoke、CI、官方测试 profile、hook、status、repo text、release notes、tag/release 结构检查、governance lint、DocSync、skill verify、lifecycle、export 和 fresh-clone。

Taskfile 只做短路由，业务逻辑在 Go 的 internal/* 包中。PowerShell/Python 只保留专项质量、安全、计划模式（Plan Mode）、外部 skill、tag planning / overlay compatibility 和硬件/工具链专项流程。

Git Governance Standard

AiCoding 使用仓库内置 Git Governance Standard。

• commit type taxonomy：feat, fix, docs, style, refactor, perf, test, build, ci, chore。
• branch naming and environment mapping：main, develop, feature, test, release, hotfix。
• Release typed notes：发布说明按主类型汇总，并由 .github/RELEASE_TEMPLATE.md 和 bin/aicoding.exe verify release-notes --json 验证。

快速开始

go run ./cmd/aicoding bootstrap --json
bin\aicoding.exe smoke --json
bin\aicoding.exe ci --profile Smoke --json
task smoke
bin\aicoding.exe test full --json
bin\aicoding.exe test release --json

常用入口

场景	命令	说明
初始化	go run ./cmd/aicoding bootstrap --json	构建 bin/aicoding.exe
本地 Smoke	task smoke	路由到 bin/aicoding.exe smoke --json
CI Smoke	bin\aicoding.exe ci --profile Smoke --json	Go 测试和默认聚合门禁
Full	task full	路由到官方 Full 测试 profile
Release	task release	路由到官方 Release 测试 profile
最近测试报告	bin\aicoding.exe test latest	查看最近一次官方测试摘要

架构图

User / Agent
  -> Taskfile routing
     -> Go CLI (bin/aicoding.exe)
        -> runner plans -> smoke / ci
        -> test profiles -> full / release / latest
        -> kit registry -> CodingKit assets + skill submodule
     -> specialty scripts -> quality / safety / Plan Mode / toolchain

文档索引

主题	文档
架构总览	docs/ARCHITECTURE_OVERVIEW.md
命令矩阵	docs/COMMANDS.md
官方测试	docs/operations/testing/GLOBAL_TEST_PLAN.md
PowerShell 当前边界	docs/architecture/POWERSHELL_BOUNDARY.md
Release governance overlay	docs/governance/RELEASE_GOVERNANCE_OVERLAY.md
Tag policy	docs/governance/TAGGING_POLICY.md
Release policy	docs/governance/RELEASE_POLICY.md

Tag 规则摘要

• 平台发布 tag：vMAJOR.MINOR.PATCH。
• Kit/component 发布 tag：kit/<kit-id>/vMAJOR.MINOR.PATCH。
• Milestone tag：milestone/YYYY.MM.DD-<name>。
• 不移动、不覆盖、不复用已经绑定 release 的 immutable tag。

Repository map

Generated from config/repository-navigation.json. Edit the configuration, not this block.

Area	Purpose	Audience	Entry
CodingKit/	Authoritative skill/plugin assets and submodule boundary.	maintainer, agent	CodingKit/agents/skills
cmd/	Go executable entry points only.	developer	cmd/aicoding
config/	Machine-readable platform configuration, registries, policies and schemas.	maintainer, agent	config/README.md
docs/	Canonical human documentation.	user, contributor, maintainer	docs/README.md
internal/	Go platform implementation packages.	developer	internal/README.md
testdata/	Fixtures and sample repositories; no executable business logic.	developer	testdata
tools/	Standalone specialty, migration, testing and template tooling.	maintainer, agent	tools/README.md

Common routes

Need	Start here	Command
初始化或构建 AiCoding	cmd/aicoding	go run ./cmd/aicoding bootstrap --json
查找平台命令	docs/COMMANDS.md	bin/aicoding.exe governance layout --json
修改架构或包边界	docs/architecture	—
修改 Hook、发布或 Git 治理	docs/governance	aicoding governance layout --json
维护 kit 注册表或生命周期	config	bin/aicoding.exe status --all --json
运行完整验证	docs/operations	bin/aicoding.exe test full --json
维护专项工具	tools	—
维护 Skill 权威源码	CodingKit/agents/skills	—