hyb-oa-delivery-trellis-only 移除项目交付 Skill 并统一 Trellis-only 治理

这个提交包含在:
2026-05-26 11:20:56 +08:00
父节点 1b5c7527b7
当前提交 fd4059d511
共修改 19 个文件,包含 207 行新增和 288 行删除
@@ -0,0 +1,4 @@
{"file": ".trellis/spec/hyb-oa/index.md", "reason": "hyb-oa spec entry point for verification"}
{"file": ".trellis/spec/hyb-oa/project-governance.md", "reason": "verify Trellis task contract and approval rules"}
{"file": ".trellis/spec/hyb-oa/docs-and-evidence.md", "reason": "verify docs registry and evidence consistency"}
{"file": ".trellis/spec/hyb-oa/security-privacy.md", "reason": "verify no sensitive data is introduced"}
@@ -0,0 +1,4 @@
{"file": ".trellis/spec/hyb-oa/index.md", "reason": "hyb-oa spec entry point for Trellis-only governance"}
{"file": ".trellis/spec/hyb-oa/project-governance.md", "reason": "Trellis task contract and approval rules"}
{"file": ".trellis/spec/hyb-oa/docs-and-evidence.md", "reason": "docs registry and evidence-source rules"}
{"file": ".trellis/spec/hyb-oa/security-privacy.md", "reason": "privacy and sensitive-data boundaries during docs migration"}
@@ -0,0 +1,24 @@
# Implementation Notes
## Approach
- Remove the project-local delivery skill as an executable governance source.
- Move current operational guidance to Trellis workflow/spec/task files and existing docs fact sources.
- Keep historical Issue CSVs untouched.
- Update governance checks so deleted skill references in current governance files fail the Trellis gate.
## Files
- `AGENTS.md`
- `docs/Agent开发交付实践.md`
- `docs/文档索引.md`
- `docs/文档事实源状态矩阵.md`
- `scripts/qa/audit-docs.mjs`
- `scripts/qa/check-process-contract.mjs`
- `scripts/qa/check-trellis-governance.mjs`
- `.trellis/tasks/05-26-trellis2-official-task-contract/`
- `.agents/skills/`
## Rollback
This is a docs/governance-only cleanup. Roll back by reverting this task's file changes and restoring the deleted project skill files from git history if the Trellis-only gate proves too strict.
@@ -0,0 +1,82 @@
# Remove hyb-oa Delivery Skill And Enforce Trellis-Only Governance
## Goal
Make Trellis the single development and governance entry point for hyb-oa by
removing the project-local `hyb-oa-delivery` skill and moving any current
governance responsibility to `.trellis/workflow.md`, `.trellis/spec/hyb-oa/`,
current Trellis task PRDs, and `docs/` fact sources.
## Scope
- Remove `.agents/skills/hyb-oa-delivery/` from the repo.
- Update `AGENTS.md` so it no longer requires or recommends the project skill.
- Update docs and registries that currently list `hyb-oa-delivery` as a current
fact source.
- Update governance QA scripts so they validate Trellis workflow/spec/docs/task
contracts without requiring the deleted skill path.
- Preserve Trellis built-in skills such as `trellis-start`, `trellis-before-dev`,
`trellis-check`, `trellis-update-spec`, and `trellis-meta`.
- Preserve `docs/` as the business fact source and historical Issue CSVs as
audit evidence only.
## Out Of Scope
- No backend or frontend business-code changes.
- No deployment or public OA verification.
- No database, Enterprise WeChat, payment, production config, or real-data write.
- No deletion or bulk rewrite of historical `issues/*.csv` files.
- No removal of generic Trellis skills generated by Trellis init.
## Requirements
- `hyb-oa-delivery` must no longer be an auto-triggerable project skill.
- Stable project rules that still matter must be reachable through
`.trellis/spec/hyb-oa/` and `docs/文档索引.md`, not through the deleted skill.
- Governance checks must fail if future docs or scripts still require the
deleted skill as a current path.
- Historical mentions may remain only when clearly historical evidence, not as
a current execution source.
- The current task must remain the execution contract for this migration.
## Acceptance
- `.agents/skills/hyb-oa-delivery/` is deleted.
- `AGENTS.md` describes Trellis-only entry and no longer points to
`.agents/skills/hyb-oa-delivery`.
- `docs/文档索引.md` and `docs/文档事实源状态矩阵.md` no longer register the deleted
skill as a current fact source.
- `scripts/qa/check-trellis-governance.mjs` and
`scripts/qa/check-process-contract.mjs` no longer require the deleted skill.
- `rg -n "hyb-oa-delivery|\\.agents/skills/hyb-oa-delivery|项目 Skill 优先"`
returns no current operational references, except this task or historical
notes if explicitly marked as historical.
- Trellis governance and docs registry checks pass.
## Test Plan
- `python3 ./.trellis/scripts/task.py validate 05-26-hyb-oa-delivery-trellis-only`
- `node --check scripts/qa/check-trellis-governance.mjs`
- `node --check scripts/qa/check-process-contract.mjs`
- `node --check scripts/qa/audit-docs.mjs`
- `node scripts/qa/check-trellis-governance.mjs`
- `node scripts/qa/check-process-contract.mjs --baseline --json`
- `node scripts/qa/audit-docs.mjs --check-registry`
- `rg -n "hyb-oa-delivery|\\.agents/skills/hyb-oa-delivery|项目 Skill 优先" AGENTS.md .trellis docs scripts .agents .codex .github`
- `git diff --check`
## Privacy
Do not write passwords, token, Secret, real invoice originals, contract bodies,
bank materials, full accounts, complete local paths, or raw payloads in Trellis
tasks, docs, reports, or chat.
## Implementation Plan
1. Remove project-skill references from AGENTS and docs current-source lists.
2. Update governance scripts to require Trellis spec/docs instead of the deleted
project skill.
3. Delete `.agents/skills/hyb-oa-delivery/`.
4. Run the test plan above.
5. If checks expose stale references, update only current governance/docs paths
needed for Trellis-only consistency.
@@ -0,0 +1,39 @@
{
"id": "hyb-oa-delivery-trellis-only",
"name": "hyb-oa-delivery-trellis-only",
"title": "Remove hyb-oa delivery skill and enforce Trellis-only governance",
"description": "Remove the project-local hyb-oa-delivery skill and make Trellis workflow/spec/tasks/docs the single governance entry point.",
"status": "in_progress",
"dev_type": "docs",
"scope": "trellis-governance",
"package": "docs",
"priority": "P2",
"creator": "shunli",
"assignee": "shunli",
"createdAt": "2026-05-26",
"completedAt": null,
"branch": null,
"base_branch": "main",
"worktree_path": null,
"commit": null,
"pr_url": null,
"subtasks": [],
"children": [],
"parent": null,
"relatedFiles": [
"AGENTS.md",
".trellis/spec/hyb-oa/",
"scripts/qa/check-trellis-governance.mjs",
"scripts/qa/check-process-contract.mjs",
"scripts/qa/audit-docs.mjs",
"docs/文档索引.md",
"docs/文档事实源状态矩阵.md",
"docs/Agent开发交付实践.md",
".agents/skills/hyb-oa-delivery/"
],
"notes": "No business code, no deployment, no public OA data writes. Requires user approval before deleting the project-local skill.",
"meta": {
"contractMode": "trellis_task",
"intent": "trellis_only_governance"
}
}
@@ -29,7 +29,7 @@ holds the PRD, implementation context, verification context and finish record.
without requiring Issue CSV bindings.
- Current active Trellis tasks have PRD/test/scope information sufficient for
the new check.
- Documentation and the project skill agree on Trellis task-first operation.
- Documentation, AGENTS and Trellis specs agree on Trellis task-first operation.
## Test Plan
@@ -38,7 +38,6 @@ holds the PRD, implementation context, verification context and finish record.
- `node --check scripts/qa/check-trellis-governance.mjs`
- `node scripts/qa/check-trellis-governance.mjs`
- `node scripts/qa/audit-docs.mjs --check-registry`
- `python3 /home/shunli/.codex/skills/.system/skill-creator/scripts/quick_validate.py .agents/skills/hyb-oa-delivery`
- `git diff --check`
- `bash scripts/check-minimal.sh`
@@ -24,15 +24,15 @@
"AGENTS.md",
".trellis/workflow.md",
".trellis/spec/hyb-oa/project-governance.md",
".trellis/spec/hyb-oa/index.md",
"scripts/qa/check-trellis-governance.mjs",
"docs/Agent开发交付实践.md",
"docs/文档索引.md",
"docs/文档事实源状态矩阵.md",
".agents/skills/hyb-oa-delivery/SKILL.md"
"docs/文档事实源状态矩阵.md"
],
"notes": "No business code, no deployment, no public OA data writes. TRELLIS2 intentionally creates no Issue CSV.",
"meta": {
"contractMode": "trellis_task",
"supersedesPolicy": "TRELLIS1 dual-track Issue CSV binding"
}
}
}